Certificate - List
Belirtilen Hesaba eklenmiş olan tüm Sertifikaları listeler.
Uyarı: Bu işlem kullanım dışı bırakıldı ve Şubat 2024'den sonra kaldırılacak. Lütfen bunun yerine Azure KeyVault Uzantısını kullanın.
GET {batchUrl}/certificates?api-version=2023-11-01.18.0
GET {batchUrl}/certificates?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Tüm Azure Batch hizmet isteklerinin temel URL'si. |
api-version
|
query | True |
string |
İstemci API Sürümü. |
$filter
|
query |
string |
OData $filter yan tümcesi. Bu filtreyi oluşturma hakkında daha fazla bilgi için bkz https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-certificates. . |
|
$select
|
query |
string |
OData $select yan tümcesi. |
|
maxresults
|
query |
integer int32 |
Yanıtta döndürülecek en fazla öğe sayısı. En fazla 1000 Sertifika döndürülebilir. |
|
timeout
|
query |
integer int32 |
Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir. |
İstek Başlığı
Media Types: "application/json; odata=minimalmetadata"
Name | Gerekli | Tür | Description |
---|---|---|---|
client-request-id |
string uuid |
Çağıran tarafından oluşturulan istek kimliği, küme ayraçları gibi dekorasyonu olmayan bir GUID biçimindedir; örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Sunucunun yanıtta client-request-id döndürip döndürmeyeceği. |
|
ocp-date |
string date-time-rfc1123 |
İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saatine ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Sertifika listesini içeren bir yanıt. Üst Bilgiler
|
|
Other Status Codes |
Batch hizmetinden gelen hata. |
Güvenlik
azure_auth
OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | Kullanıcı hesabınızın kimliğine bürünme |
Authorization
Tür:
apiKey
İçinde:
header
Örnekler
Certificate list
Örnek isteği
GET account.region.batch.azure.com/certificates?api-version=2023-11-01.18.0
Örnek yanıt
{
"value": [
{
"thumbprint": "0123456789abcdef0123456789abcdef01234567",
"thumbprintAlgorithm": "sha1",
"url": "https://account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)",
"state": "deletefailed",
"stateTransitionTime": "2014-07-31T21:12:58.236Z",
"previousState": "deleting",
"previousStateTransitionTime": "2014-07-31T21:11:58.236Z",
"publicData": "#####...",
"deleteCertificateError": {
"code": "PoolsReferencingCertificate",
"message": "The specified certificate is being used by the below mentioned pool(s)",
"values": [
{
"name": "Pools",
"value": "mypool1"
}
]
}
}
]
}
Tanımlar
Name | Description |
---|---|
Batch |
Azure Batch hizmetinden alınan bir hata yanıtı. |
Batch |
Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe. |
Certificate |
İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika. |
Certificate |
Hesaptaki Sertifikaları listelemenin sonucu. |
Certificate |
Sertifikanın durumu. |
Delete |
Sertifika silinirken Batch hizmeti tarafından karşılaşılan bir hata. |
Error |
Azure Batch hata yanıtında bir hata iletisi alındı. |
Name |
Ad-değer çiftini temsil eder. |
BatchError
Azure Batch hizmetinden alınan bir hata yanıtı.
Name | Tür | Description |
---|---|---|
code |
string |
Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır. |
message |
Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti. |
|
values |
Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu. |
BatchErrorDetail
Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.
Name | Tür | Description |
---|---|---|
key |
string |
Value özelliğinin anlamını belirten tanımlayıcı. |
value |
string |
Hata yanıtına eklenen ek bilgiler. |
Certificate
İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika.
Name | Tür | Description |
---|---|---|
deleteCertificateError |
Bu Sertifikayı silmeye son denemede oluşan hata. |
|
previousState |
Sertifikanın önceki durumu. |
|
previousStateTransitionTime |
string |
Sertifikanın önceki durumuna girdiği saat. |
publicData |
string |
Sertifikanın base-64 kodlanmış .cer dosyası olarak ortak bölümü. |
state |
Sertifikanın geçerli durumu. |
|
stateTransitionTime |
string |
Sertifikanın geçerli durumuna girdiği saat. |
thumbprint |
string |
Sertifikanın X.509 parmak izi. Bu, en fazla 40 onaltılık basamak dizisidir. |
thumbprintAlgorithm |
string |
Parmak izini türetmek için kullanılan algoritma. |
url |
string |
Sertifikanın URL'si. |
CertificateListResult
Hesaptaki Sertifikaları listelemenin sonucu.
Name | Tür | Description |
---|---|---|
odata.nextLink |
string |
Sonraki sonuç kümesini almak için URL. |
value |
Sertifika listesi. |
CertificateState
Sertifikanın durumu.
Name | Tür | Description |
---|---|---|
active |
string |
Sertifika Havuzlar'da kullanılabilir. |
deletefailed |
string |
Kullanıcı Sertifikanın silinmesini istedi, ancak Sertifikaya hala başvurular içeren Havuzlar var veya bir veya daha fazla Düğümde yüklü. (Sertifika Havuzdan kaldırılmışsa ancak İşlem Düğümü henüz yeniden başlatılmamışsa ikinci durum oluşabilir. İşlem Düğümleri sertifikalarını yalnızca yeniden başlattıklarında yeniler.) Silme işlemini iptal etmek için Sertifika silme işlemini veya silmeyi yeniden denemek için Sertifika silme işlemini kullanabilirsiniz. |
deleting |
string |
Kullanıcı Sertifikanın silinmesini istedi, ancak silme işlemi henüz tamamlanmadı. Havuzları oluştururken veya güncelleştirirken Sertifikaya başvuramayın. |
DeleteCertificateError
Sertifika silinirken Batch hizmeti tarafından karşılaşılan bir hata.
Name | Tür | Description |
---|---|---|
code |
string |
Sertifika silme hatasının tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır. |
message |
string |
Kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan Sertifika silme hatasını açıklayan bir ileti. |
values |
Sertifika silme hatasıyla ilgili ek hata ayrıntılarının listesi. |
ErrorMessage
Azure Batch hata yanıtında bir hata iletisi alındı.
Name | Tür | Description |
---|---|---|
lang |
string |
Hata iletisinin dil kodu |
value |
string |
İletinin metni. |
NameValuePair
Ad-değer çiftini temsil eder.
Name | Tür | Description |
---|---|---|
name |
string |
Ad-değer çiftindeki ad. |
value |
string |
Ad-değer çiftindeki değer. |