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
catalogName
path True

string

pattern: ^[a-zA-Z0-9-]{3,24}$

A katalógus neve

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
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

ManagedServiceIdentity

Az erőforráshoz rendelt felügyeltszolgáltatás-identitások.

properties

GeoCatalogProperties

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

GeoCatalog

Az erőforrás 'GeoCatalog' frissítési művelete sikeres

201 Created

GeoCatalog

Resource 'GeoCatalog' létrehozása sikeres

Fejlécek

  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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
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ó.

CatalogTier

A Microsoft Planetary Computer Pro GeoCatalog szintje

createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

GeoCatalog

Microsoft Planetary Computer Pro GeoCatalog forrás

GeoCatalogProperties

A Microsoft Planetary Computer Pro GeoCatalog részletei.

ManagedServiceIdentity

Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt 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).

ProvisioningState

Az aktuális művelet állapota.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

UserAssignedIdentity

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

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célpontja.

ErrorResponse

Hibaválasz

Név Típus Description
error

ErrorDetail

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

ManagedServiceIdentity

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

GeoCatalogProperties

Az erőforrás erőforrás-specifikus tulajdonságai.

systemData

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

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

ProvisioningState

Az utolsó művelet állapota.

tier

CatalogTier

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

ManagedServiceIdentityType

A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identitások
Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsok arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben.

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

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

createdByType

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.