Dps Certificate - Create Or Update

Odwołanie

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Przekaż certyfikat do usługi aprowizacji.
Dodaj nowy certyfikat lub zaktualizuj istniejący certyfikat.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}?api-version=2022-12-12

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
certificateName	path	True	string	Nazwa certyfikatu tworzenia lub aktualizowania.
provisioningServiceName	path	True	string	Nazwa usługi aprowizacji.
resourceGroupName	path	True	string	Identyfikator grupy zasobów.
subscriptionId	path	True	string	Identyfikator subskrypcji.
api-version	query	True	string	Wersja interfejsu API.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-Match		string	ETag certyfikatu. Jest to wymagane do zaktualizowania istniejącego certyfikatu i zignorowane podczas tworzenia zupełnie nowego certyfikatu.

Treść żądania

Nazwa	Typ	Opis
properties	CertificateProperties	właściwości certyfikatu

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CertificateResponse	Jeśli certyfikat już istnieje i aktualizacja zakończyła się pomyślnie, operacja zwraca kod stanu HTTP 201 (OK).
Other Status Codes	ErrorDetails	Domyślna odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

DPSCreateOrUpdateCertificate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert?api-version=2022-12-12

{
  "properties": {
    "certificate": "MA=="
  }
}

Sample Response

Status code:: 200

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "certificate": "MA==",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": false,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:23:50 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServives/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/ProvisioningServices/Certificates",
  "etag": "AAAAAAExpNs="
}

Definicje

Nazwa	Opis
CertificateProperties	Opis certyfikatu urzędu certyfikacji X509.
CertificateResponse	Certyfikat X509.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorDetails	Szczegóły błędu.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

CertificateProperties

Opis certyfikatu urzędu certyfikacji X509.

Nazwa	Typ	Opis
certificate	string	reprezentacja certyfikatu X509 w formacie base-64 .cer pliku lub tylko zawartość pliku pem.
created	string	Data i godzina utworzenia certyfikatu.
expiry	string	Data i godzina wygaśnięcia certyfikatu.
isVerified	boolean	Określa, czy certyfikat został zweryfikowany.
subject	string	Nazwa podmiotu certyfikatu.
thumbprint	string	Odcisk palca certyfikatu.
updated	string	Data i godzina ostatniej aktualizacji certyfikatu.

CertificateResponse

Certyfikat X509.

Nazwa	Typ	Opis
etag	string	Tag jednostki.
id	string	Identyfikator zasobu.
name	string	Nazwa certyfikatu.
properties	CertificateProperties	właściwości certyfikatu
systemData	systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
type	string	Typ zasobu.

createdByType

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

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
code	integer	Kod błędu.
details	string	Szczegóły błędu.
httpStatusCode	string	Kod stanu HTTP.
message	string	Komunikat o błędzie.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (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	Sygnatura czasowa 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.