If true will successfully store an unparseable resource name into the UnparsedResource
property; otherwise will throw an ArgumentException if an unparseable resource name is
specified.
If true will successfully store an unparseable resource name into the UnparsedResource
property; otherwise will throw an ArgumentException if an unparseable resource name is
specified.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-12 UTC."],[[["\u003cp\u003eThis webpage provides reference documentation for the \u003ccode\u003eInstanceName\u003c/code\u003e class within the Google Cloud OS Config v1 API, specifically for the .NET environment.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eInstanceName\u003c/code\u003e class is used as a resource name for \u003ccode\u003eInstance\u003c/code\u003e resources and can be constructed using component parts such as \u003ccode\u003eprojectId\u003c/code\u003e, \u003ccode\u003ezoneId\u003c/code\u003e, and \u003ccode\u003einstanceId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThere are several available methods to work with \u003ccode\u003eInstanceName\u003c/code\u003e, including formatting, parsing, and comparing instance name strings, to properly handle instance resources.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eInstanceName\u003c/code\u003e class has properties like \u003ccode\u003eProjectId\u003c/code\u003e, \u003ccode\u003eZoneId\u003c/code\u003e, and \u003ccode\u003eInstanceId\u003c/code\u003e, which may be null depending on the resource name contained in the instance.\u003c/p\u003e\n"],["\u003cp\u003eThe webpage lists the availability of the Google Cloud OS Config v1 API over multiple different versions, with the most recent version being 2.4.0, while also being able to go as far back as 1.3.0.\u003c/p\u003e\n"]]],[],null,["# Google Cloud OS Config v1 API - Class InstanceName (2.5.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.5.0 (latest)](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName)\n- [2.4.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/2.4.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [2.3.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/2.3.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [2.2.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/2.2.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [2.1.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/2.1.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [2.0.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/2.0.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [1.8.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/1.8.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [1.7.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/1.7.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [1.6.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/1.6.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [1.5.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/1.5.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [1.4.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/1.4.0/Google.Cloud.OsConfig.V1.InstanceName)\n- [1.3.0](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/1.3.0/Google.Cloud.OsConfig.V1.InstanceName) \n\n public sealed class InstanceName : IResourceName, IEquatable\u003cInstanceName\u003e\n\nReference documentation and code samples for the Google Cloud OS Config v1 API class InstanceName.\n\nResource name for the `Instance` resource. \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e InstanceName \n\nImplements\n----------\n\n[IResourceName](https://cloud.google.com/dotnet/docs/reference/Google.Api.Gax/latest/Google.Api.Gax.IResourceName.html), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) \n\nInherited Members\n-----------------\n\n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype)\n\nNamespace\n---------\n\n[Google.Cloud.OsConfig.V1](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1)\n\nAssembly\n--------\n\nGoogle.Cloud.OsConfig.V1.dll\n\nConstructors\n------------\n\n### InstanceName(string, string, string)\n\n public InstanceName(string projectId, string zoneId, string instanceId)\n\nConstructs a new instance of a [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) class from the component parts of pattern\n`projects/{project}/zones/{zone}/instances/{instance}`\n\nProperties\n----------\n\n### InstanceId\n\n public string InstanceId { get; }\n\nThe `Instance` ID. May be `null`, depending on which resource name is contained by this instance.\n\n### IsKnownPattern\n\n public bool IsKnownPattern { get; }\n\nWhether this instance contains a resource name with a known pattern.\n\n### LocationId\n\n public string LocationId { get; }\n\nThe `Location` ID. May be `null`, depending on which resource name is contained by this instance.\n\n### ProjectId\n\n public string ProjectId { get; }\n\nThe `Project` ID. May be `null`, depending on which resource name is contained by this instance.\n\n### Type\n\n public InstanceName.ResourceNameType Type { get; }\n\nThe [InstanceName.ResourceNameType](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName.ResourceNameType) of the contained resource name.\n\n### UnparsedResource\n\n public UnparsedResourceName UnparsedResource { get; }\n\nThe contained [UnparsedResourceName](https://cloud.google.com/dotnet/docs/reference/Google.Api.Gax/latest/Google.Api.Gax.UnparsedResourceName.html). Only non-`null` if this instance contains an\nunparsed resource name.\n\n### ZoneId\n\n public string ZoneId { get; }\n\nThe `Zone` ID. May be `null`, depending on which resource name is contained by this instance.\n\nMethods\n-------\n\n### Format(string, string, string)\n\n public static string Format(string projectId, string zoneId, string instanceId)\n\nFormats the IDs into the string representation of this [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) with pattern\n`projects/{project}/zones/{zone}/instances/{instance}`.\n\n### FormatProjectLocationInstance(string, string, string)\n\n public static string FormatProjectLocationInstance(string projectId, string locationId, string instanceId)\n\nFormats the IDs into the string representation of this [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) with pattern\n`projects/{project}/locations/{location}/instances/{instance}`.\n\n### FormatProjectZoneInstance(string, string, string)\n\n public static string FormatProjectZoneInstance(string projectId, string zoneId, string instanceId)\n\nFormats the IDs into the string representation of this [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) with pattern\n`projects/{project}/zones/{zone}/instances/{instance}`.\n\n### FromProjectLocationInstance(string, string, string)\n\n public static InstanceName FromProjectLocationInstance(string projectId, string locationId, string instanceId)\n\nCreates a [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) with the pattern\n`projects/{project}/locations/{location}/instances/{instance}`.\n\n### FromProjectZoneInstance(string, string, string)\n\n public static InstanceName FromProjectZoneInstance(string projectId, string zoneId, string instanceId)\n\nCreates a [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) with the pattern\n`projects/{project}/zones/{zone}/instances/{instance}`.\n\n### FromUnparsed(UnparsedResourceName)\n\n public static InstanceName FromUnparsed(UnparsedResourceName unparsedResourceName)\n\nCreates a [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) containing an unparsed resource name.\n\n### GetHashCode()\n\n public override int GetHashCode()\n\nReturns a hash code for this resource name.\n\n**Overrides** \n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode)\n\n### Parse(string)\n\n public static InstanceName Parse(string instanceName)\n\nParses the given resource name string into a new [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) instance.\n\n**Remarks** \nTo parse successfully, the resource name must be formatted as one of the following:\n\n- `projects/{project}/zones/{zone}/instances/{instance}`\n- `projects/{project}/locations/{location}/instances/{instance}`\n\n\u003cbr /\u003e\n\n### Parse(string, bool)\n\n public static InstanceName Parse(string instanceName, bool allowUnparsed)\n\nParses the given resource name string into a new [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) instance; optionally allowing an\nunparseable resource name.\n\n**Remarks** \nTo parse successfully, the resource name must be formatted as one of the following:\n\n- `projects/{project}/zones/{zone}/instances/{instance}`\n- `projects/{project}/locations/{location}/instances/{instance}`\n\nOr may be in any format if `allowUnparsed` is `true`.\n\n\u003cbr /\u003e\n\n### ToString()\n\n public override string ToString()\n\nThe string representation of the resource name.\n\n**Overrides** \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\n### TryParse(string, out InstanceName)\n\n public static bool TryParse(string instanceName, out InstanceName result)\n\nTries to parse the given resource name string into a new [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) instance.\n\n**Remarks** \nTo parse successfully, the resource name must be formatted as one of the following:\n\n- `projects/{project}/zones/{zone}/instances/{instance}`\n- `projects/{project}/locations/{location}/instances/{instance}`\n\n\u003cbr /\u003e\n\n### TryParse(string, bool, out InstanceName)\n\n public static bool TryParse(string instanceName, bool allowUnparsed, out InstanceName result)\n\nTries to parse the given resource name string into a new [InstanceName](/dotnet/docs/reference/Google.Cloud.OsConfig.V1/latest/Google.Cloud.OsConfig.V1.InstanceName) instance; optionally\nallowing an unparseable resource name.\n\n**Remarks** \nTo parse successfully, the resource name must be formatted as one of the following:\n\n- `projects/{project}/zones/{zone}/instances/{instance}`\n- `projects/{project}/locations/{location}/instances/{instance}`\n\nOr may be in any format if `allowUnparsed` is `true`.\n\n\u003cbr /\u003e\n\nOperators\n---------\n\n### operator ==(InstanceName, InstanceName)\n\n public static bool operator ==(InstanceName a, InstanceName b)\n\nDetermines whether two specified resource names have the same value.\n\n### operator !=(InstanceName, InstanceName)\n\n public static bool operator !=(InstanceName a, InstanceName b)\n\nDetermines whether two specified resource names have different values."]]
