Bagikan melalui

Dps Certificate - Create Or Update

  • Referensi
Layanan:
IoT Hub Device Provisioning Service
Versi API:
2022-12-12

Unggah sertifikat ke layanan provisi.
Tambahkan sertifikat baru atau perbarui sertifikat yang sudah ada.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
certificateName
 path True

string

maxLength: 256

Nama sertifikat yang dibuat atau diperbarui.
provisioningServiceName
 path True

string

Nama layanan provisi.
resourceGroupName
 path True

string

Pengidentifikasi grup sumber daya.
subscriptionId
 path True

string

Pengidentifikasi langganan.
api-version
 query True

string

Versi API.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
If-Match

string

ETag sertifikat. Ini diperlukan untuk memperbarui sertifikat yang ada, dan diabaikan saat membuat sertifikat baru.

Isi Permintaan

Nama Jenis Deskripsi
properties

CertificateProperties

properti sertifikat

Respons

Nama Jenis Deskripsi
200 OK

CertificateResponse

Jika sertifikat sudah ada dan pembaruan berhasil, operasi mengembalikan kode status HTTP 201 (OK).
Other Status Codes

ErrorDetails

Respons kesalahan default.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

DPSCreateOrUpdateCertificate

Permintaan sampel

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=="
  }
}

Respon sampel

Kode status:
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="
}

Definisi

Nama Deskripsi
CertificateProperties

Penjabaran dari Sertifikat CA X509.
CertificateResponse

Sertifikat X509.
createdByType

Jenis identitas yang membuat sumber daya.
ErrorDetails

Detail kesalahan.
systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

CertificateProperties

Objek

Penjabaran dari Sertifikat CA X509.

Nama Jenis Deskripsi
certificate

string (byte)

representasi base-64 dari sertifikat X509 .cer file atau hanya konten file .pem.
created

string (date-time-rfc1123)

Tanggal dan waktu pembuatan sertifikat.
expiry

string (date-time-rfc1123)

Tanggal dan waktu kedaluwarsa sertifikat.
isVerified

boolean

Menentukan apakah sertifikat telah diverifikasi.
subject

string

Nama subjek sertifikat.
thumbprint

string

Thumbprint sertifikat.
updated

string (date-time-rfc1123)

Tanggal dan waktu pembaruan terakhir sertifikat.

CertificateResponse

Objek

Sertifikat X509.

Nama Jenis Deskripsi
etag

string

Tag entitas.
id

string

Pengidentifikasi sumber daya.
name

string

Nama sertifikat.
properties

CertificateProperties

properti sertifikat
systemData

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
type

string

Jenis sumber daya.

createdByType

Enumeration

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
Application
Key
ManagedIdentity
User

ErrorDetails

Objek

Detail kesalahan.

Nama Jenis Deskripsi
code

integer (int32)

Kode kesalahan.
details

string

Detail kesalahan.
httpStatusCode

string

Kode status HTTP.
message

string

Pesan kesalahan.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).
createdBy

string

Identitas yang membuat sumber daya.
createdByType

createdByType

Jenis identitas yang membuat sumber daya.
lastModifiedAt

string (date-time)

Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.
lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.