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

string

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

Nazwa wykazu

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
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

ManagedServiceIdentity

Tożsamości usługi zarządzanej przypisane do tego zasobu.

properties

GeoCatalogProperties

Właściwości specyficzne dla zasobu dla tego zasobu.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

GeoCatalog

Aktualizacja zasobu 'GeoCatalog' zakończyła się sukcesem

201 Created

GeoCatalog

Operacja tworzenia zasobu 'GeoCatalog' zakończyła się sukcesem

Nagłówki

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

ErrorResponse

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
AutoGeneratedDomainNameLabelScope

Zakres, w którym generowana jest automatycznie generowana etykieta nazwy domeny oraz w którym można ponownie użyć nazwy zasobu.

CatalogTier

Poziom Microsoft Planetary Computer Pro GeoCatalog

createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

GeoCatalog

Źródło GeoKatalogu Microsoft Planetary Computer Pro

GeoCatalogProperties

Szczegóły katalogu Microsoft Planetary Computer Pro GeoCatalog.

ManagedServiceIdentity

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

ProvisioningState

Stan bieżącej operacji.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

UserAssignedIdentity

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

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

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

ManagedServiceIdentity

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

GeoCatalogProperties

Właściwości specyficzne dla zasobu dla tego zasobu.

systemData

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

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

ProvisioningState

Stan ostatniej operacji.

tier

CatalogTier

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

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

tożsamości User-Assigned
Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

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

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

createdByType

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.