GeoCatalogs - Create
Stwórz GeoKatalog
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/geoCatalogs/{catalogName}?api-version=2026-04-15
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
catalog
|
path | True |
string pattern: ^[a-zA-Z0-9-]{3,24}$ |
Nazwa wykazu |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string (uuid) |
Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| location | True |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| identity |
Tożsamości usługi zarządzanej przypisane do tego zasobu. |
||
| properties |
Właściwości specyficzne dla zasobu dla tego zasobu. |
||
| tags |
object |
Tagi zasobów. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Aktualizacja zasobu 'GeoCatalog' zakończyła się sukcesem |
|
| 201 Created |
Operacja tworzenia zasobu 'GeoCatalog' zakończyła się sukcesem Nagłówki
|
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Przepływ protokołu OAuth2 usługi Azure Active Directory.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
GeoCatalogs_Create
Przykładowe żądanie
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"
}
Przykładowa odpowiedź
{
"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"
}
}
Definicje
| Nazwa | Opis |
|---|---|
|
Auto |
Zakres, w którym generowana jest automatycznie generowana etykieta nazwy domeny oraz w którym można ponownie użyć nazwy zasobu. |
|
Catalog |
Poziom Microsoft Planetary Computer Pro GeoCatalog |
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
Geo |
Źródło GeoKatalogu Microsoft Planetary Computer Pro |
|
Geo |
Szczegóły katalogu Microsoft Planetary Computer Pro GeoCatalog. |
|
Managed |
Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika) |
|
Managed |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
|
Provisioning |
Stan bieżącej operacji. |
|
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
User |
Właściwości tożsamości przypisanej przez użytkownika |
AutoGeneratedDomainNameLabelScope
Zakres, w którym generowana jest automatycznie generowana etykieta nazwy domeny oraz w którym można ponownie użyć nazwy zasobu.
| Wartość | Opis |
|---|---|
| NoReuse |
Etykieta domeny jest generowana losowo. Nazwy zasobu nie można ponownie użyć w tym samym regionie. |
| TenantReuse |
Etykieta nazwy domeny jest deterministycznie generowana na podstawie nazwy zasobu i identyfikatora najemcy. Nazwy zasobu nie można ponownie użyć w tym samym regionie i dzierżawie. |
| SubscriptionReuse |
Etykieta nazwy domeny jest deterministycznie generowana przy użyciu nazwy zasobu, identyfikatora najemcy oraz identyfikatora subskrypcji. Nazwy zasobu nie można ponownie używać w tym samym regionie i subskrypcji. |
| ResourceGroupReuse |
Etykieta nazwy domeny jest deterministycznie generowana za pomocą nazwy zasobu, identyfikatora najemcy, identyfikatora subskrypcji oraz nazwy grupy zasobów. Nazwa zasobu nie może być ponownie użyta w obrębie tej samej grupy zasobów. |
CatalogTier
Poziom Microsoft Planetary Computer Pro GeoCatalog
| Wartość | Opis |
|---|---|
| Basic |
Podstawowy poziom, który wykorzystuje wspólne zasoby w instancjach katalogowych |
createdByType
Typ tożsamości, która utworzyła zasób.
| Wartość | Opis |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
object |
Dodatkowe informacje. |
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| additionalInfo |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |
GeoCatalog
Źródło GeoKatalogu Microsoft Planetary Computer Pro
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string (arm-id) |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Tożsamości usługi zarządzanej przypisane do tego zasobu. |
|
| location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| name |
string |
Nazwa zasobu |
| properties |
Właściwości specyficzne dla zasobu dla tego zasobu. |
|
| systemData |
Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”. |
|
| tags |
object |
Tagi zasobów. |
| type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
GeoCatalogProperties
Szczegóły katalogu Microsoft Planetary Computer Pro GeoCatalog.
| Nazwa | Typ | Domyślna wartość | Opis |
|---|---|---|---|
| autoGeneratedDomainNameLabelScope | TenantReuse |
Zakres automatycznie wygenerowanej etykiety nazwy domeny. Jeśli nie zostanie podany, wartość domyślna to TenantReuse. |
|
| catalogUri |
string |
URI interfejsu zarządzania katalogiem. |
|
| provisioningState |
Stan ostatniej operacji. |
||
| tier | Basic |
Warstwa katalogu. Nie można tego zmienić po utworzeniu katalogu. Jeśli nie zostanie podany, wartość domyślna to Podstawowa. |
ManagedServiceIdentity
Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)
| Nazwa | Typ | Opis |
|---|---|---|
| principalId |
string (uuid) |
Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
| tenantId |
string (uuid) |
Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
| type |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
|
| userAssignedIdentities |
<string,
User |
tożsamości User-Assigned |
ManagedServiceIdentityType
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
| Wartość | Opis |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
ProvisioningState
Stan bieżącej operacji.
| Wartość | Opis |
|---|---|
| Succeeded |
Zasób został utworzony. |
| Failed |
Tworzenie zasobu nie powiodło się. |
| Canceled |
Tworzenie zasobu zostało anulowane. |
| Provisioning |
Katalog jest przygotowywany. |
| Updating |
Katalog jest aktualizowany. |
| Deleting |
Katalog jest usuwany. |
| Accepted |
Prośba o katalog została zaakceptowana. |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
| Nazwa | Typ | Opis |
|---|---|---|
| createdAt |
string (date-time) |
Sygnatura czasowa tworzenia zasobu (UTC). |
| createdBy |
string |
Tożsamość, która utworzyła zasób. |
| createdByType |
Typ tożsamości, która utworzyła zasób. |
|
| lastModifiedAt |
string (date-time) |
Znacznik czasu ostatniej modyfikacji zasobu (UTC) |
| lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
| lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
UserAssignedIdentity
Właściwości tożsamości przypisanej przez użytkownika
| Nazwa | Typ | Opis |
|---|---|---|
| clientId |
string (uuid) |
Identyfikator klienta przypisanej tożsamości. |
| principalId |
string (uuid) |
Identyfikator podmiotu zabezpieczeń przypisanej tożsamości. |