Remediations - Get At Resource

Hizmet:: Policy

API Sürümü:: 2024-10-01

Kaynak kapsamında var olan bir düzeltmeyi alır.

GET https://management.azure.com/{resourceId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}?api-version=2024-10-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
remediationName	path	True	string	Düzeltmenin adı.
resourceId	path	True	string	Kaynak Kimliği.
api-version	query	True	string	İstemci Api Sürümü.

Yanıtlar

Name	Tür	Description
200 OK	Remediation	Alınan düzeltme.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

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

Örnekler

Get remediation at individual resource scope

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/resourcegroups/myResourceGroup/providers/microsoft.storage/storageaccounts/storAc1/providers/Microsoft.PolicyInsights/remediations/storageRemediation?api-version=2024-10-01

Örnek yanıt

Durum kodu:: 200

{
  "properties": {
    "policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/resourcegroups/myResourceGroup/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
    "provisioningState": "Succeeded",
    "createdOn": "2018-09-13T21:51:09.075918Z",
    "lastUpdatedOn": "2018-09-13T21:52:10.0011706Z",
    "resourceDiscoveryMode": "ExistingNonCompliant",
    "deploymentStatus": {
      "totalDeployments": 1,
      "successfulDeployments": 1,
      "failedDeployments": 0
    },
    "statusMessage": "Remediation extended status",
    "correlationId": "a14e1d60-dae9-4771-b4be-a556d69e77a6",
    "resourceCount": 42,
    "parallelDeployments": 6,
    "failureThreshold": {
      "percentage": 0.1
    }
  },
  "id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/resourcegroups/myResourceGroup/providers/microsoft.storage/storageaccounts/storAc1/providers/microsoft.policyinsights/remediations/storageRemediation",
  "name": "storageRemediation",
  "type": "Microsoft.PolicyInsights/remediations",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
    "createdByType": "User",
    "createdAt": "2018-09-13T21:51:09.075918Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2018-09-13T21:52:10.0011706Z"
  }
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorDefinition	Hata tanımı.
ErrorResponse	Hata yanıtı.
FailureThreshold	Düzeltme hatası eşik ayarları
Remediation	Düzeltme tanımı.
RemediationDeploymentSummary	Düzeltme tarafından oluşturulan tüm dağıtımlar için dağıtım durumu özeti.
RemediationFilters	Hangi kaynakların düzeltileceğini belirlemek için uygulanacak filtreler.
ResourceDiscoveryMode	Düzeltilmeye ilişkin kaynaklar bulunur. Belirtilmezse varsayılan olarak ExistingNonCompliant değerini kullanır.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
TypedErrorInfo	Senaryoya özgü hata ayrıntıları.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

ErrorDefinition

Nesne

Hata tanımı.

Name	Tür	Description
additionalInfo	TypedErrorInfo[]	Ek senaryoya özgü hata ayrıntıları.
code	string	HTTP hata kodu için alt durum olarak hizmet veren hizmete özgü hata kodu.
details	ErrorDefinition[]	İç hata ayrıntıları.
message	string	Hatanın açıklaması.
target	string	Hatanın hedefi.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
error	ErrorDefinition	Hata ayrıntıları.

FailureThreshold

Nesne

Düzeltme hatası eşik ayarları

Name	Tür	Description
percentage	number (float)	Hata yüzdesi eşiğini temsil eden 0,0 ile 1,0 arasında bir sayı. Başarısız düzeltme işlemlerinin yüzdesi (başarısız dağıtımlar) bu eşiği aşarsa düzeltme başarısız olur.

Remediation

Nesne

Düzeltme tanımı.

Name	Tür	Description
id	string	Düzeltmenin kimliği.
name	string	Düzeltmenin adı.
properties.correlationId	string	Düzeltme bağıntı kimliği. Etkinlik günlüğünde düzeltmeyle ilgili olayları bulmak için kullanılabilir.
properties.createdOn	string (date-time)	Düzeltmenin oluşturulduğu saat.
properties.deploymentStatus	RemediationDeploymentSummary	Düzeltme tarafından oluşturulan tüm dağıtımlar için dağıtım durumu özeti.
properties.failureThreshold	FailureThreshold	Düzeltme hatası eşik ayarları
properties.filters	RemediationFilters	Hangi kaynakların düzeltileceğini belirlemek için uygulanacak filtreler.
properties.lastUpdatedOn	string (date-time)	Düzeltmenin en son güncelleştirildiği saat.
properties.parallelDeployments	integer (int32)	Herhangi bir zamanda kaç kaynağın düzeltileceğini belirler. Düzeltme hızını artırmak veya azaltmak için kullanılabilir. Sağlanmazsa, varsayılan paralel dağıtımlar değeri kullanılır.
properties.policyAssignmentId	string	Düzeltilmesi gereken ilke atamasının kaynak kimliği.
properties.policyDefinitionReferenceId	string	Düzeltilmesi gereken tek tek tanımın ilke tanımı başvuru kimliği. düzeltilmekte olan ilke ataması bir ilke kümesi tanımı atadığında gereklidir.
properties.provisioningState	string	Düzeltmenin durumu. Bu, tek tek dağıtımları değil, tüm düzeltme görevini ifade eder. İzin verilen değerler Değerlendiriliyor, İptal Edildi, İptal Edildi, Başarısız, Tamamlandı veya Başarılı oldu.
properties.resourceCount	integer (int32)	Düzeltme işi tarafından düzeltilebilen en fazla kaynak sayısını belirler. Sağlanmadıysa, varsayılan kaynak sayısı kullanılır.
properties.resourceDiscoveryMode	ResourceDiscoveryMode	Düzeltilmeye ilişkin kaynaklar bulunur. Belirtilmezse varsayılan olarak ExistingNonCompliant değerini kullanır.
properties.statusMessage	string	Düzeltme durum iletisi. Düzeltmenin durumuyla ilgili ek ayrıntılar sağlar.
systemData	systemData	Azure Resource Manager metadata içeren createdBy ve modifiedBy bilgileri.
type	string	Düzeltmenin türü.

RemediationDeploymentSummary

Nesne

Düzeltme tarafından oluşturulan tüm dağıtımlar için dağıtım durumu özeti.

Name	Tür	Description
failedDeployments	integer	Düzeltme için gerekli olan ve başarısız olan dağıtım sayısı.
successfulDeployments	integer	Başarılı olan düzeltmenin gerektirdiği dağıtım sayısı.
totalDeployments	integer	Düzeltme için gereken dağıtım sayısı.

RemediationFilters

Nesne

Hangi kaynakların düzeltileceğini belirlemek için uygulanacak filtreler.

Name	Tür	Description
locations	string[]	Düzeltilecek kaynak konumları.
resourceIds	string[]	Düzeltilecek kaynakların kimlikleri. En fazla 100 kimlik belirtebilir. ReEvaluateCompliance, ReEvaluateCompliance olarak ayarlandığında bu filtre kullanılamaz ve sağlanırsa boş olamaz.

ResourceDiscoveryMode

Numaralandırma

Düzeltilmeye ilişkin kaynaklar bulunur. Belirtilmezse varsayılan olarak ExistingNonCompliant değerini kullanır.

Değer	Description
ExistingNonCompliant	Uyumlu olmayan olduğu bilinen kaynakları düzeltin.
ReEvaluateCompliance	Kaynakların uyumluluk durumunu yeniden değerlendirin ve uyumsuz olduğu belirlenen kaynakları düzeltin. ResourceIds filtresi bu modda kullanılamaz.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

TypedErrorInfo

Nesne

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ü.

Aracılığıyla paylaş

Remediations - Get At Resource

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

Get remediation at individual resource scope

Örnek isteği

Örnek yanıt

Tanımlar

createdByType

ErrorDefinition

ErrorResponse

FailureThreshold

Remediation

RemediationDeploymentSummary

RemediationFilters

ResourceDiscoveryMode

systemData

TypedErrorInfo