Certificate - List By Batch Account

Layanan:: Batch Management

Versi API:: 2024-07-01

Mencantumkan semua sertifikat di akun yang ditentukan.
Peringatan: Operasi ini tidak digunakan lagi dan akan dihapus setelah Februari 2024. Gunakan Ekstensi Azure KeyVault sebagai gantinya.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates?api-version=2024-07-01

Dengan parameter opsional:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates?api-version=2024-07-01&maxresults={maxresults}&$select={$select}&$filter={$filter}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-zA-Z0-9]+$	Nama untuk akun Batch yang harus unik di wilayah tersebut. Nama akun batch harus terdiri dari antara 3 dan 24 karakter dan hanya boleh menggunakan angka dan huruf kecil. Nama ini digunakan sebagai bagian dari nama DNS yang digunakan untuk mengakses layanan Batch di wilayah tempat akun dibuat. Misalnya: `http://accountname.region.batch.azure.com/`.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
$filter	query		string	Ekspresi filter OData. Properti yang valid untuk pemfilteran adalah "properties/provisioningState", "properties/provisioningStateTransitionTime", "name".
$select	query		string	Daftar properti yang dipisahkan koma yang harus dikembalikan. misalnya, "properties/provisioningState". Hanya properti tingkat atas di bawah properti/ yang valid untuk pilihan.
maxresults	query		integer (int32)	Jumlah maksimum item yang akan dikembalikan dalam respons.

Respons

Nama	Jenis	Deskripsi
200 OK	ListCertificatesResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	CloudError	Respons kesalahan tak terduga.

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

ListCertificates

ListCertificates - Filter and Select

ListCertificates

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates?api-version=2024-07-01

Respon sampel

Kode status:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates?api-version=2024-07-01&$skiptoken=NPK%3D28%3A2857p428pug%2022F53A7734C947B8NRK%3D45%3Asha1-c23dc7f22edc793856a7506fe66397ccb4a33b46SM%3D5%3AFalse",
  "value": [
    {
      "name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
      "type": "Microsoft.Batch/batchAccounts/certificates",
      "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
      "properties": {
        "format": "Pfx",
        "provisioningState": "Succeeded",
        "provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
        "publicData": "MIICrjCCAZagAwI...",
        "thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
        "thumbprintAlgorithm": "sha1"
      }
    }
  ]
}

ListCertificates - Filter and Select

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates?api-version=2024-07-01&$select=properties/format,properties/provisioningState&$filter=properties/provisioningStateTransitionTime gt '2017-05-01' or properties/provisioningState eq 'Failed'

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
      "type": "Microsoft.Batch/batchAccounts/certificates",
      "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
      "properties": {
        "format": "Pfx",
        "provisioningState": "Failed"
      }
    },
    {
      "name": "sha1-aeb228ffb0bf67a793d61dce263ebd16949f15a1",
      "type": "Microsoft.Batch/batchAccounts/certificates",
      "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-aeb228ffb0bf67a793d61dce263ebd16949f15a1",
      "properties": {
        "format": "Cer",
        "provisioningState": "Failed"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
Certificate	Berisi informasi tentang sertifikat.
CertificateFormat	Format sertifikat - baik Pfx atau Cer. Jika dihilangkan, defaultnya adalah Pfx.
CertificateProvisioningState	Status provisi sertifikat saat ini.
CloudError	Respons kesalahan dari layanan Batch.
CloudErrorBody	Respons kesalahan dari layanan Batch.
createdByType	Jenis identitas yang membuat sumber daya.
DeleteCertificateError	Respons kesalahan dari layanan Batch.
ListCertificatesResult	Nilai yang dikembalikan oleh operasi Daftar.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Certificate

Objek

Berisi informasi tentang sertifikat.

Nama	Jenis	Deskripsi
etag	string	ETag sumber daya, digunakan untuk pernyataan konkurensi.
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties.deleteCertificateError	DeleteCertificateError	Kesalahan yang terjadi saat menghapus sertifikat Ini hanya dikembalikan ketika provisioningState sertifikat 'Gagal'.
properties.format	CertificateFormat	Format sertifikat - baik Pfx atau Cer. Jika dihilangkan, defaultnya adalah Pfx.
properties.previousProvisioningState	CertificateProvisioningState	Status sumber daya yang disediakan sebelumnya
properties.previousProvisioningStateTransitionTime	string (date-time)	Waktu saat sertifikat memasuki status sebelumnya. Waktu saat sertifikat memasuki status sebelumnya.
properties.provisioningState	CertificateProvisioningState	Status sumber daya yang disediakan Status sumber daya yang disediakan
properties.provisioningStateTransitionTime	string (date-time)	Waktu saat sertifikat memasuki statusnya saat ini. Waktu saat sertifikat memasuki statusnya saat ini.
properties.publicData	string	Kunci umum sertifikat.
properties.thumbprint	string	Thumbprint sertifikat. Ini harus cocok dengan thumbprint dari nama.
properties.thumbprintAlgorithm	string	Algoritma thumbprint sertifikat. Ini harus cocok dengan bagian pertama dari nama sertifikat. Saat ini diperlukan untuk menjadi 'SHA1'.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

CertificateFormat

Enumerasi

Format sertifikat - baik Pfx atau Cer. Jika dihilangkan, defaultnya adalah Pfx.

Nilai	Deskripsi
Pfx	Sertifikat adalah sertifikat berformat PFX (PKCS#12) atau rantai sertifikat.
Cer	Sertifikat adalah sertifikat X.509 yang dikodekan base64.

CertificateProvisioningState

Enumerasi

Status provisi sertifikat saat ini.

Nilai	Deskripsi
Succeeded	Sertifikat tersedia untuk digunakan dalam kumpulan.
Deleting	Pengguna telah meminta agar sertifikat dihapus, tetapi operasi penghapusan belum selesai. Anda mungkin tidak mereferensikan sertifikat saat membuat atau memperbarui kumpulan.
Failed	Pengguna meminta agar sertifikat dihapus, tetapi ada kumpulan yang masih memiliki referensi ke sertifikat, atau masih diinstal pada satu atau beberapa simpul komputasi. (Yang terakhir dapat terjadi jika sertifikat telah dihapus dari kumpulan, tetapi simpul belum dimulai ulang. Simpul me-refresh sertifikat mereka hanya ketika mereka memulai ulang.) Anda dapat menggunakan operasi batalkan penghapusan sertifikat untuk membatalkan penghapusan, atau operasi hapus sertifikat untuk mencoba kembali penghapusan.

CloudError

Objek

Respons kesalahan dari layanan Batch.

Nama	Jenis	Deskripsi
error	CloudErrorBody	Isi respons kesalahan.

CloudErrorBody

Objek

Respons kesalahan dari layanan Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
details	CloudErrorBody[]	Daftar detail tambahan tentang kesalahan.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DeleteCertificateError

Objek

Respons kesalahan dari layanan Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
details	DeleteCertificateError[]	Daftar detail tambahan tentang kesalahan.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

ListCertificatesResult

Objek

Nilai yang dikembalikan oleh operasi Daftar.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	Certificate[]	Item Sertifikat di halaman ini

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)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.