Attestations - List For Subscription
Abonelik için tüm kanıtlamaları alır.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations?api-version=2022-09-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations?$top={$top}&$filter={$filter}&api-version=2022-09-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Hedef aboneliğin kimliği. |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
$filter
|
query |
string |
OData filtre ifadesi. |
|
$top
|
query |
integer int32 |
Döndürülecek kayıt sayısı üst sınırı. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Alınan kanıtlamalar. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
List attestations at subscription scope |
List attestations at subscription scope with query parameters |
List attestations at subscription scope
Sample Request
GET https://management.azure.com/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/Microsoft.PolicyInsights/attestations?api-version=2022-09-01
Sample Response
{
"value": [
{
"properties": {
"policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
"policyDefinitionReferenceId": "0b158b46-ff42-4799-8e39-08a5c23b4551",
"complianceState": "Compliant",
"lastComplianceStateChangeAt": "2020-06-15T18:52:27Z",
"expiresOn": "2021-06-15T00:00:00Z",
"owner": "55a32e28-3aa5-4eea-9b5a-4cd85153b966",
"comments": "This subscription has passed a security audit.",
"evidence": [
{
"description": "The results of the security audit.",
"sourceUri": "https://gist.github.com/contoso/9573e238762c60166c090ae16b814011"
}
],
"assessmentDate": "2021-06-10T00:00:00Z",
"metadata": {
"departmentId": "NYC-MARKETING-1"
},
"provisioningState": "Succeeded"
},
"systemData": {
"createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
"createdByType": "User",
"createdAt": "2020-06-15T18:52:27Z",
"lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-06-15T18:52:27Z"
},
"id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.policyinsights/attestations/790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
"name": "790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
"type": "Microsoft.PolicyInsights/attestations"
},
{
"properties": {
"policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/090a47f8-13e9-441e-ad90-dc666cc5d487",
"complianceState": "Compliant",
"lastComplianceStateChangeAt": "2020-06-15T18:52:27Z",
"provisioningState": "Succeeded"
},
"systemData": {
"createdBy": "34709f31-f267-4eee-8479-0da11925f2f2",
"createdByType": "User",
"createdAt": "2020-06-15T18:52:27Z",
"lastModifiedBy": "34709f31-f267-4eee-8479-0da11925f2f2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-06-15T18:52:27Z"
},
"id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/resourcegroups/myrg/providers/microsoft.policyinsights/attestations/689bfc0c-a012-49fc-af40-3ebea35ff3ed",
"name": "689bfc0c-a012-49fc-af40-3ebea35ff3ed",
"type": "Microsoft.PolicyInsights/attestations"
}
]
}
List attestations at subscription scope with query parameters
Sample Request
GET https://management.azure.com/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/Microsoft.PolicyInsights/attestations?$top=1&$filter=PolicyAssignmentId eq '/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5' AND PolicyDefinitionReferenceId eq '0b158b46-ff42-4799-8e39-08a5c23b4551'&api-version=2022-09-01
Sample Response
{
"value": [
{
"properties": {
"policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
"policyDefinitionReferenceId": "0b158b46-ff42-4799-8e39-08a5c23b4551",
"complianceState": "Compliant",
"lastComplianceStateChangeAt": "2020-06-15T18:52:27Z",
"expiresOn": "2021-06-15T00:00:00Z",
"owner": "55a32e28-3aa5-4eea-9b5a-4cd85153b966",
"comments": "This subscription has passed a security audit.",
"evidence": [
{
"description": "The results of the security audit.",
"sourceUri": "https://gist.github.com/contoso/9573e238762c60166c090ae16b814011"
}
],
"assessmentDate": "2021-06-10T00:00:00Z",
"metadata": {
"departmentId": "NYC-MARKETING-1"
},
"provisioningState": "Succeeded"
},
"systemData": {
"createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
"createdByType": "User",
"createdAt": "2020-06-15T18:52:27Z",
"lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-06-15T18:52:27Z"
},
"id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.policyinsights/attestations/790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
"name": "790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
"type": "Microsoft.PolicyInsights/attestations"
}
]
}
Tanımlar
Name | Description |
---|---|
Attestation |
Kanıtlama kaynağı. |
Attestation |
Kanıtlamada ayarlanan uyumluluk durumunu destekleyen bir kanıt parçası. |
Attestation |
Kanıtlamaların listesi. |
Compliance |
Kaynakta ayarlanması gereken uyumluluk durumu. |
created |
Kaynağı oluşturan kimliğin türü. |
Error |
Hata tanımı. |
Error |
Hata yanıtı. |
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
Typed |
Senaryoya özgü hata ayrıntıları. |
Attestation
Kanıtlama kaynağı.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Kaynağın adı |
properties.assessmentDate |
string |
Kanıtın değerlendirildiği zaman |
properties.comments |
string |
Bu kanıtlamanın neden oluşturulduğunu açıklayan açıklamalar. |
properties.complianceState |
Kaynakta ayarlanması gereken uyumluluk durumu. |
|
properties.evidence |
Bu kanıtlamada ayarlanan uyumluluk durumunu destekleyen kanıtlar. |
|
properties.expiresOn |
string |
Uyumluluk durumunun süresinin dolması gereken süre. |
properties.lastComplianceStateChangeAt |
string |
Bu kanıtlamada uyumluluk durumunun son değiştirildiği saat. |
properties.metadata |
object |
Bu kanıtlama için ek meta veriler |
properties.owner |
string |
Kaynağın durumunu ayarlamakla sorumlu kişi. Bu değer genellikle bir Azure Active Directory nesne kimliğidir. |
properties.policyAssignmentId |
string |
Kanıtlamanın durumunu ayarlayan ilke atamasının kaynak kimliği. |
properties.policyDefinitionReferenceId |
string |
Kanıtlamanın durumunu ayarlandığı ilke kümesi tanımından ilke tanımı başvuru kimliği. İlke ataması bir ilke kümesi tanımı atarsa, kanıtlama bu özellik ile küme tanımı içinde bir tanım seçebilir veya bunu atlayabilir ve küme tanımının tamamının durumunu ayarlayabilir. |
properties.provisioningState |
string |
Kanıtlamanın durumu. |
systemData |
Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
AttestationEvidence
Kanıtlamada ayarlanan uyumluluk durumunu destekleyen bir kanıt parçası.
Name | Tür | Description |
---|---|---|
description |
string |
Bu kanıtın açıklaması. |
sourceUri |
string |
Kanıtın URI konumu. |
AttestationListResult
Kanıtlamaların listesi.
Name | Tür | Description |
---|---|---|
nextLink |
string |
Sonraki sonuç kümesini almak için URL. |
value |
Kanıtlama tanımları dizisi. |
ComplianceState
Kaynakta ayarlanması gereken uyumluluk durumu.
Name | Tür | Description |
---|---|---|
Compliant |
string |
Kaynak ilkeyle uyumlu. |
NonCompliant |
string |
Kaynak ilkeyle uyumlu değil. |
Unknown |
string |
Kaynağın uyumluluk durumu bilinmiyor. |
createdByType
Kaynağı oluşturan kimliğin türü.
Name | Tür | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorDefinition
Hata tanımı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Senaryoya özgü ek hata ayrıntıları. |
|
code |
string |
HTTP hata kodu için alt durum görevi gören hizmete özgü hata kodu. |
details |
İç hata ayrıntıları. |
|
message |
string |
Hatanın açıklaması. |
target |
string |
Hatanın hedefi. |
ErrorResponse
Hata yanıtı.
Name | Tür | Description |
---|---|---|
error |
Hata ayrıntıları. |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string |
Kaynağın son değişikliğinin zaman damgası (UTC) |
lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
lastModifiedByType |
Kaynağı en son değiştiren kimliğin türü. |
TypedErrorInfo
Senaryoya özgü hata ayrıntıları.
Name | Tür | Description |
---|---|---|
info |
Senaryoya özgü hata ayrıntıları. |
|
type |
string |
Eklenen hata ayrıntılarının türü. |