GeoCatalogs - Create
Létrehozz egy GeoCatalog-t
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/geoCatalogs/{catalogName}?api-version=2026-04-15
URI-paraméterek
| Név | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
catalog
|
path | True |
string pattern: ^[a-zA-Z0-9-]{3,24}$ |
A katalógus neve |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
subscription
|
path | True |
string (uuid) |
A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
Kérelem törzse
| Név | Kötelező | Típus | Description |
|---|---|---|---|
| location | True |
string |
Az a földrajzi hely, ahol az erőforrás él |
| identity |
Az erőforráshoz rendelt felügyeltszolgáltatás-identitások. |
||
| properties |
Az erőforrás erőforrás-specifikus tulajdonságai. |
||
| tags |
object |
Erőforráscímkék. |
Válaszok
| Név | Típus | Description |
|---|---|---|
| 200 OK |
Az erőforrás 'GeoCatalog' frissítési művelete sikeres |
|
| 201 Created |
Resource 'GeoCatalog' létrehozása sikeres Fejlécek
|
|
| Other Status Codes |
Váratlan hibaválasz. |
Biztonság
azure_auth
Azure Active Directory Oauth2-folyamat.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Név | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
GeoCatalogs_Create
Mintakérelem
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"
}
Mintaválasz
{
"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"
}
}
Definíciók
| Név | Description |
|---|---|
|
Auto |
Az a terület, ahol az automatikusan generált domain név címkéje létrejött, és ahol az erőforrás neve újra használható. |
|
Catalog |
A Microsoft Planetary Computer Pro GeoCatalog szintje |
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Error |
Az erőforrás-kezelési hiba további információi. |
|
Error |
A hiba részletei. |
|
Error |
Hibaválasz |
|
Geo |
Microsoft Planetary Computer Pro GeoCatalog forrás |
|
Geo |
A Microsoft Planetary Computer Pro GeoCatalog részletei. |
|
Managed |
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások) |
|
Managed |
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). |
|
Provisioning |
Az aktuális művelet állapota. |
|
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
|
User |
Felhasználó által hozzárendelt identitástulajdonságok |
AutoGeneratedDomainNameLabelScope
Az a terület, ahol az automatikusan generált domain név címkéje létrejött, és ahol az erőforrás neve újra használható.
| Érték | Description |
|---|---|
| NoReuse |
A domain név címkéje véletlenszerűen generálódik. Az erőforrás neve ugyanabban a régióban nem használható újra. |
| TenantReuse |
A domain név címke determinisztikusan generálódik az erőforrás név és a bérlőazonosító alapján. Az erőforrás neve nem használható újra ugyanazon a régióban és a bérlőn. |
| SubscriptionReuse |
A domain név címkét determinisztikusan generálják az erőforrás név, a bérlőazonosító és az előfizetési azonosító alapján. Az erőforrás neve ugyanazon a régióban és előfizetésben nem használható újra. |
| ResourceGroupReuse |
A domain név címkét determinisztikusan generálják az erőforrás név, a bérlőazonosító, az előfizetési azonosító és az erőforráscsoport név alapján. Az erőforrás neve ugyanazon erőforráscsoporton belül nem használható újra. |
CatalogTier
A Microsoft Planetary Computer Pro GeoCatalog szintje
| Érték | Description |
|---|---|
| Basic |
Az alap szint, amely megosztott erőforrásokat használ a katalóguspéldányok között |
createdByType
Az erőforrást létrehozó identitás típusa.
| Érték | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
| Név | Típus | Description |
|---|---|---|
| info |
object |
A további információk. |
| type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
| Név | Típus | Description |
|---|---|---|
| additionalInfo |
A hiba további információi. |
|
| code |
string |
A hibakód. |
| details |
A hiba részletei. |
|
| message |
string |
A hibaüzenet. |
| target |
string |
A hiba célpontja. |
ErrorResponse
Hibaválasz
| Név | Típus | Description |
|---|---|---|
| error |
A hibaobjektum. |
GeoCatalog
Microsoft Planetary Computer Pro GeoCatalog forrás
| Név | Típus | Description |
|---|---|---|
| id |
string (arm-id) |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| identity |
Az erőforráshoz rendelt felügyeltszolgáltatás-identitások. |
|
| location |
string |
Az a földrajzi hely, ahol az erőforrás él |
| name |
string |
Az erőforrás neve |
| properties |
Az erőforrás erőforrás-specifikus tulajdonságai. |
|
| systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
|
| tags |
object |
Erőforráscímkék. |
| type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
GeoCatalogProperties
A Microsoft Planetary Computer Pro GeoCatalog részletei.
| Név | Típus | Alapértelmezett érték | Description |
|---|---|---|---|
| autoGeneratedDomainNameLabelScope | TenantReuse |
Az automatikusan létrehozott tartománynévcímke hatóköre. Ha nincs megadva, az alapértelmezett beállítás a TenantReuse. |
|
| catalogUri |
string |
A katalóguskezelő felület URI-je. |
|
| provisioningState |
Az utolsó művelet állapota. |
||
| tier | Basic |
A katalógus szintje. Ez a katalógus létrehozása után nem módosítható. Ha nincs megadva, az alapértelmezett beállítás Alapszintű. |
ManagedServiceIdentity
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)
| Név | Típus | Description |
|---|---|---|
| principalId |
string (uuid) |
A rendszer által hozzárendelt identitás szolgáltatásnév-azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva. |
| tenantId |
string (uuid) |
A rendszer által hozzárendelt identitás bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva. |
| type |
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned identitások |
ManagedServiceIdentityType
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).
| Érték | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
ProvisioningState
Az aktuális művelet állapota.
| Érték | Description |
|---|---|
| Succeeded |
Az erőforrás létrejött. |
| Failed |
Az erőforrás létrehozása nem sikerült. |
| Canceled |
Az erőforrás létrehozása megszakadt. |
| Provisioning |
A katalógust készítik. |
| Updating |
A katalógust frissítik. |
| Deleting |
A katalógust töröljük. |
| Accepted |
A katalóguskérést elfogadták. |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
| Név | Típus | Description |
|---|---|---|
| createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
| createdBy |
string |
Az erőforrást létrehozó identitás. |
| createdByType |
Az erőforrást létrehozó identitás típusa. |
|
| lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
| lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
| lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |
UserAssignedIdentity
Felhasználó által hozzárendelt identitástulajdonságok
| Név | Típus | Description |
|---|---|---|
| clientId |
string (uuid) |
A hozzárendelt identitás ügyfélazonosítója. |
| principalId |
string (uuid) |
A hozzárendelt identitás egyszerű azonosítója. |