Dps Certificate - Get

Usługa:

IoT Hub Device Provisioning Service

Wersja interfejsu API:

2022-12-12

Pobierz certyfikat z usługi aprowizacji.

GET 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 do pobrania.
provisioningServiceName	path	True	string	Nazwa usługi aprowizacji skojarzonej z certyfikatem.
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	Element ETag certyfikatu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CertificateResponse	Metadane określonego certyfikatu.
Other Status Codes	ErrorDetails	Domyślna 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

DPSGetCertificate

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

200

{
  "properties": {
    "subject": "CN=testdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "certificate": "MA==",
    "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/IotHubs/andbuc-hub/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

Objekt

Opis certyfikatu urzędu certyfikacji X509.

Nazwa	Typ	Opis
certificate	string (byte)	Base-64 reprezentacja certyfikatu X509 .cer pliku lub tylko zawartość pliku pem.
created	string (date-time-rfc1123)	Data i godzina utworzenia certyfikatu.
expiry	string (date-time-rfc1123)	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 (date-time-rfc1123)	Data i godzina ostatniej aktualizacji certyfikatu.

CertificateResponse

Objekt

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

Wyliczanie

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

Wartość	Opis
Application
Key
ManagedIdentity
User

ErrorDetails

Objekt

Szczegóły błędu.

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

systemData

Objekt

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.