Udostępnij przez

az iot ops schema registry

Note

Ta dokumentacja jest częścią rozszerzenia azure-iot-ops dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie rejestru schematu az iot ops. Dowiedz się więcej o rozszerzeniach.

Zarządzanie rejestrem schematów.

Rejestr schematów to scentralizowane repozytorium do zarządzania schematami. Rejestr schematów umożliwia generowanie i pobieranie schematów zarówno na brzegu, jak i w chmurze. Zapewnia spójność i zgodność między systemami, zapewniając jedno źródło prawdy dla definicji schematu.

Polecenia

Nazwa Opis Typ Stan
az iot ops schema registry create

Utwórz rejestr schematów.

 Extension ogólna dostępność
az iot ops schema registry delete

Usuń docelowy rejestr schematów.

 Extension ogólna dostępność
az iot ops schema registry list

Wyświetlanie listy rejestrów schematów w grupie zasobów lub subskrypcji.

 Extension ogólna dostępność
az iot ops schema registry show

Pokaż szczegóły rejestru schematów.

 Extension ogólna dostępność

az iot ops schema registry create

Utwórz rejestr schematów.

Ta operacja spowoduje utworzenie rejestru schematów z włączoną tożsamością zarządzaną systemu.

Następnie przypisze tożsamość systemową wbudowaną rolę "Współautor danych obiektu blob usługi Storage" względem zakresu kontenera konta magazynu. W razie potrzeby możesz podać rolę niestandardową za pomocą polecenia --custom-role-id, aby zamiast tego użyć.

Jeśli wskazany kontener konta magazynu nie istnieje, zostanie utworzony z ustawieniami domyślnymi.

Ta operacja spowoduje również zarejestrowanie dostawcy zasobów Microsoft.DeviceRegistry, jeśli nie jest zarejestrowany.

az iot ops schema registry create --name
                                  --registry-namespace --rn
                                  --resource-group
                                  --sa-resource-id
                                  [--custom-role-id]
                                  [--desc]
                                  [--display-name]
                                  [--location]
                                  [--sa-container]
                                  [--skip-ra {false, true}]
                                  [--tags]

Przykłady

Utwórz rejestr schematów o nazwie "myregistry" z minimalnymi danymi wejściowymi.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID

Utwórz rejestr schematów o nazwie "myregistry" w regionie westus2 z dodatkowym dostosowaniem.

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID --sa-container myschemacontainer -l westus2 --desc 'Contoso factory X1 schemas' --display-name 'Contoso X1' --tags env=prod

Parametry wymagane

--name -n

Nazwa rejestru schematu.

--registry-namespace --rn

Przestrzeń nazw rejestru schematów. Unikatowo identyfikuje rejestr schematów w dzierżawie.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--sa-resource-id

Identyfikator zasobu konta magazynu, który ma być używany z rejestrem schematów.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--custom-role-id

Identyfikator definicji roli w pełni kwalifikowanej w następującym formacie: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}.

Właściwość Wartość
Grupa parametrów: Role Assignment Arguments
--desc

Opis rejestru schematów.

--display-name

Nazwa wyświetlana rejestru schematów.

--location -l

Region do utworzenia rejestru schematów. Jeśli nie zostanie podana żadna lokalizacja, zostanie użyta lokalizacja grupy zasobów.

--sa-container

Nazwa kontenera konta magazynu, w którym będą przechowywane schematy.

Właściwość Wartość
Domyślna wartość: schemas
--skip-ra

W przypadku użycia kroku przypisania roli operacji zostanie pominięty.

Właściwość Wartość
Grupa parametrów: Role Assignment Arguments
Dopuszczalne wartości: false, true
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az iot ops schema registry delete

Usuń docelowy rejestr schematów.

az iot ops schema registry delete --name
                                  [--resource-group]
                                  [--yes {false, true}]

Przykłady

Usuń rejestr schematów "myregistry".

az iot ops schema registry delete -n myregistry -g myresourcegroup

Parametry wymagane

--name -n

Nazwa rejestru schematu.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--yes -y

Potwierdź [y]es bez monitu. Przydatne w scenariuszach ciągłej integracji i automatyzacji.

Właściwość Wartość
Dopuszczalne wartości: false, true
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az iot ops schema registry list

Wyświetlanie listy rejestrów schematów w grupie zasobów lub subskrypcji.

az iot ops schema registry list [--resource-group]

Przykłady

Wyświetl listę rejestrów schematów w grupie zasobów "myresourcegroup".

az iot ops schema registry list -g myresourcegroup

Wyświetlanie listy rejestrów schematów w domyślnym filtrowaniu subskrypcji dla określonego tagu.

az iot ops schema registry list --query "[?tags.env == 'prod']"

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az iot ops schema registry show

Pokaż szczegóły rejestru schematów.

az iot ops schema registry show --name
                                --resource-group

Przykłady

Pokaż szczegóły rejestru schematów docelowych "myregistry".

az iot ops schema registry show --name myregistry -g myresourcegroup

Parametry wymagane

--name -n

Nazwa rejestru schematu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False