GeoCatalogs - Create
Erstellen Sie einen GeoKatalog
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/geoCatalogs/{catalogName}?api-version=2026-04-15
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
catalog
|
path | True |
string pattern: ^[a-zA-Z0-9-]{3,24}$ |
Der Name des Katalogs |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string (uuid) |
Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Anforderungstext
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| location | True |
string |
Der geografische Standort, an dem sich die Ressource befindet |
| identity |
Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. |
||
| properties |
Die ressourcenspezifischen Eigenschaften für diese Ressource. |
||
| tags |
object |
Ressourcentags. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Aktualisierung der Ressource 'GeoCatalog' war erfolgreich |
|
| 201 Created |
Die Erstellungsoperation der Ressource 'GeoCatalog' war erfolgreich Header
|
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
GeoCatalogs_Create
Beispielanforderung
PUT https://management.azure.com/subscriptions/cd9b6cdf-dcf0-4dca-ab19-82be07b74704/resourceGroups/MyResourceGroup/providers/Microsoft.Orbital/geoCatalogs/MyCatalog?api-version=2026-04-15
{
"properties": {
"tier": "Basic",
"autoGeneratedDomainNameLabelScope": "NoReuse"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/cd9b6cdf-dcf0-4dca-ab19-82be07b74704/resourceGroups/MyResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyManagedIdentity": {}
}
},
"tags": {
"MyTag": "MyValue"
},
"location": "eastus"
}
Beispiel für eine Antwort
{
"properties": {
"tier": "Basic",
"catalogUri": "https://mycatalog-0123456789abcdef.geocatalog.spatio.azure.com/",
"provisioningState": "Succeeded",
"autoGeneratedDomainNameLabelScope": "NoReuse"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/cd9b6cdf-dcf0-4dca-ab19-82be07b74704/resourceGroups/MyResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyManagedIdentity": {
"principalId": "1b1424a8-4d17-4a72-b47f-d1d401c1e2fd",
"clientId": "c57c7b17-2c5e-4996-8169-c74d026ffc5d"
}
}
},
"tags": {
"MyTag": "MyValue"
},
"location": "eastus",
"id": "/subscriptions/cd9b6cdf-dcf0-4dca-ab19-82be07b74704/resourceGroups/MyResourceGroup/providers/Microsoft.Orbital/geoCatalogs/MyCatalog",
"name": "MyCatalog",
"type": "Microsoft.Orbital/geoCatalogs",
"systemData": {
"createdBy": "Catalog User",
"createdByType": "User",
"createdAt": "2023-10-10T18:34:22.271Z",
"lastModifiedBy": "Catalog User",
"lastModifiedByType": "User",
"lastModifiedAt": "2023-10-10T18:34:22.271Z"
}
}
Azure-AsyncOperation: https://contoso.com/operationstatus
{
"properties": {
"tier": "Basic",
"catalogUri": "https://mycatalog-0123456789abcdef.geocatalog.spatio.azure.com/",
"provisioningState": "Accepted",
"autoGeneratedDomainNameLabelScope": "NoReuse"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/cd9b6cdf-dcf0-4dca-ab19-82be07b74704/resourceGroups/MyResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyManagedIdentity": {
"principalId": "1b1424a8-4d17-4a72-b47f-d1d401c1e2fd",
"clientId": "c57c7b17-2c5e-4996-8169-c74d026ffc5d"
}
}
},
"tags": {
"MyTag": "MyValue"
},
"location": "eastus",
"id": "/subscriptions/cd9b6cdf-dcf0-4dca-ab19-82be07b74704/resourceGroups/MyResourceGroup/providers/Microsoft.Orbital/geoCatalogs/MyCatalog",
"name": "MyCatalog",
"type": "Microsoft.Orbital/geoCatalogs",
"systemData": {
"createdBy": "Catalog User",
"createdByType": "User",
"createdAt": "2023-10-10T18:34:22.271Z",
"lastModifiedBy": "Catalog User",
"lastModifiedByType": "User",
"lastModifiedAt": "2023-10-10T18:34:22.271Z"
}
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Auto |
Der Umfang, in dem das automatisch generierte Domainnamen-Label erzeugt wird und in dem der Ressourcenname wiederverwendet werden kann. |
|
Catalog |
Die Microsoft Planetary Computer Pro GeoCatalog-Stufe |
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Geo |
Eine Microsoft Planetary Computer Pro GeoCatalog-Ressource |
|
Geo |
Die Details des Microsoft Planetary Computer Pro GeoCatalog. |
|
Managed |
Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten) |
|
Managed |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
|
Provisioning |
Der Status des aktuellen Vorgangs. |
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
|
User |
Benutzer zugewiesene Identitätseigenschaften |
AutoGeneratedDomainNameLabelScope
Der Umfang, in dem das automatisch generierte Domainnamen-Label erzeugt wird und in dem der Ressourcenname wiederverwendet werden kann.
| Wert | Beschreibung |
|---|---|
| NoReuse |
Das Domainnamen-Label wird zufällig generiert. Der Ressourcenname kann nicht innerhalb derselben Region wiederverwendet werden. |
| TenantReuse |
Das Domainnamen-Label wird deterministisch mit dem Ressourcennamen und der Tenant-ID generiert. Der Ressourcenname kann nicht innerhalb derselben Region und im selben Tenant wiederverwendet werden. |
| SubscriptionReuse |
Das Domainnamen-Label wird deterministisch unter Verwendung des Ressourcennamens, der Mieter-ID und der Abonnement-ID erstellt. Der Ressourcenname kann innerhalb derselben Region und im selben Abonnement nicht wiederverwendet werden. |
| ResourceGroupReuse |
Das Domainnamen-Label wird deterministisch unter Verwendung des Ressourcennamens, der Mieter-ID, der Abonnement-ID und des Ressourcengruppennamens erstellt. Der Ressourcenname kann nicht innerhalb derselben Ressourcengruppe wiederverwendet werden. |
CatalogTier
Die Microsoft Planetary Computer Pro GeoCatalog-Stufe
| Wert | Beschreibung |
|---|---|
| Basic |
Das Grundtier, das gemeinsame Ressourcen über Kataloginstanzen hinweg nutzt |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
object |
Die zusätzlichen Informationen. |
| type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |
GeoCatalog
Eine Microsoft Planetary Computer Pro GeoCatalog-Ressource
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. |
|
| location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
| name |
string |
Der Name der Ressource |
| properties |
Die ressourcenspezifischen Eigenschaften für diese Ressource. |
|
| systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
| tags |
object |
Ressourcentags. |
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
GeoCatalogProperties
Die Details des Microsoft Planetary Computer Pro GeoCatalog.
| Name | Typ | Standardwert | Beschreibung |
|---|---|---|---|
| autoGeneratedDomainNameLabelScope | TenantReuse |
Der Bereich der automatisch generierten Domänennamenbezeichnung. Wenn nicht angegeben, wird standardmäßig TenantReuse verwendet. |
|
| catalogUri |
string |
Die URI der Katalogverwaltungs-Benutzeroberfläche. |
|
| provisioningState |
Der Status des letzten Vorgangs. |
||
| tier | Basic |
Ebene des Katalogs. Dies kann nach dem Erstellen des Katalogs nicht mehr geändert werden. Wenn nicht angegeben, wird standardmäßig Basic verwendet. |
ManagedServiceIdentity
Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)
| Name | Typ | Beschreibung |
|---|---|---|
| principalId |
string (uuid) |
Die Dienstprinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| tenantId |
string (uuid) |
Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| type |
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned Identitäten |
ManagedServiceIdentityType
Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).
| Wert | Beschreibung |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
ProvisioningState
Der Status des aktuellen Vorgangs.
| Wert | Beschreibung |
|---|---|
| Succeeded |
Ressource wurde erstellt. |
| Failed |
Fehler bei der Ressourcenerstellung. |
| Canceled |
Die Ressourcenerstellung wurde abgebrochen. |
| Provisioning |
Der Katalog wird bereitgestellt. |
| Updating |
Der Katalog wird aktualisiert. |
| Deleting |
Der Katalog wird gelöscht. |
| Accepted |
Die Kataloganfrage wurde angenommen. |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
UserAssignedIdentity
Benutzer zugewiesene Identitätseigenschaften
| Name | Typ | Beschreibung |
|---|---|---|
| clientId |
string (uuid) |
Die Client-ID der zugewiesenen Identität. |
| principalId |
string (uuid) |
Die Prinzipal-ID der zugewiesenen Identität. |