Delen via


az iot ops schema registry

Note

Deze verwijzing maakt deel uit van de azure-iot-ops-extensie voor de Azure CLI (versie 2.67.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az iot ops schema registry-opdracht uitvoert. Meer informatie over uitbreidingen.

Schemaregisterbeheer.

Een schemaregister is een gecentraliseerde opslagplaats voor het beheren van schema's. Schemaregister maakt het genereren en ophalen van schema's mogelijk, zowel aan de rand als in de cloud. Het zorgt voor consistentie en compatibiliteit tussen systemen door één bron van waarheid te bieden voor schemadefinities.

Opdracht

Name Description Type Status
az iot ops schema registry create

Maak een schemaregister.

Extension Algemene Vergadering
az iot ops schema registry delete

Verwijder een doelschemaregister.

Extension Algemene Vergadering
az iot ops schema registry list

Schemaregisters weergeven in een resourcegroep of abonnement.

Extension Algemene Vergadering
az iot ops schema registry show

Details van een schemaregister weergeven.

Extension Algemene Vergadering

az iot ops schema registry create

Maak een schemaregister.

Met deze bewerking maakt u een schemaregister met door het systeem beheerde identiteit ingeschakeld.

Vervolgens wordt de systeemidentiteit standaard toegewezen aan de ingebouwde rol 'Inzender voor opslagblobgegevens' voor het containerbereik van het opslagaccount. Indien nodig kunt u een aangepaste rol opgeven via --custom-role-id om in plaats daarvan te gebruiken.

Als de aangegeven opslagaccountcontainer niet bestaat, wordt deze gemaakt met standaardinstellingen.

Met deze bewerking wordt ook de resourceprovider Microsoft.DeviceRegistry geregistreerd als deze niet is geregistreerd.

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]

Voorbeelden

Maak een schemaregister met de naam 'myregistry' met minimale invoer.

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

Maak een schemaregister met de naam 'myregistry' in regio westus2 met aanvullende aanpassingen.

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

Vereiste parameters

--name -n

Schemaregisternaam.

--registry-namespace --rn

Schemaregisternaamruimte. Hiermee wordt een schemaregister in een tenant uniek geïdentificeerd.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--sa-resource-id

Resource-id van opslagaccount die moet worden gebruikt met het schemaregister.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--custom-role-id

Volledig gekwalificeerde roldefinitie-id in de volgende indeling: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}.

Eigenschap Waarde
Parametergroep: Role Assignment Arguments
--desc

Beschrijving voor het schemaregister.

--display-name

Weergavenaam voor het schemaregister.

--location -l

Regio voor het maken van het schemaregister. Als er geen locatie is opgegeven, wordt de locatie van de resourcegroep gebruikt.

--sa-container

Containernaam van opslagaccount waarin schema's worden opgeslagen.

Eigenschap Waarde
Default value: schemas
--skip-ra

Wanneer u de roltoewijzingsstap van de bewerking hebt gebruikt, wordt overgeslagen.

Eigenschap Waarde
Parametergroep: Role Assignment Arguments
Geaccepteerde waarden: false, true
--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops schema registry delete

Verwijder een doelschemaregister.

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

Voorbeelden

Verwijder het schemaregister 'myregistry'.

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

Vereiste parameters

--name -n

Schemaregisternaam.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--yes -y

Bevestig [y]s zonder prompt. Handig voor CI- en automatiseringsscenario's.

Eigenschap Waarde
Geaccepteerde waarden: false, true
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops schema registry list

Schemaregisters weergeven in een resourcegroep of abonnement.

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

Voorbeelden

Lijst met schemaregisters in de resourcegroep 'myresourcegroup'.

az iot ops schema registry list -g myresourcegroup

Schemaregisters weergeven in het standaardfilter voor abonnementen op een bepaalde tag.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops schema registry show

Details van een schemaregister weergeven.

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

Voorbeelden

Details weergeven van het doelschemaregister 'myregistry'.

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

Vereiste parameters

--name -n

Schemaregisternaam.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False