type de ressource de zone

Espace de noms : microsoft.graph.security

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente un agrégat d’environnements cloud natifs (également appelés étendue cloud) utilisés pour gérer l’accès et la sécurité à grande échelle dans Microsoft Defender pour le cloud. Les zones permettent de segmenter les environnements multi-cloud, tels qu’Azure, AWS, GCP et les sources DevOps ou de registre connectées, en regroupements significatifs, ce qui permet l’application cohérente des contrôles d’accès à moindre privilège.

Lorsque vous configurez une nouvelle zone, vous pouvez lui attribuer des rôles. Pour plus d’informations sur les attributions d’autorisations de contrôle d’accès en fonction du rôle, consultez la fonction rbacApplicationMultiple.

Pour plus d’informations, consultez Gérer les étendues cloud et le contrôle d’accès unifié basé sur un rôle.

Remarque

Un client n’a pas de zone par défaut. Les environnements ne sont pas automatiquement attachés à une zone ; Elles doivent être explicitement attribuées aux zones par les administrateurs. Un environnement peut être attaché à plusieurs zones simultanément, ce qui permet un regroupement flexible et des scénarios de contrôle d’accès qui se chevauchent.

Hérite de l’entité.

Méthodes

Méthode	Type de retour	Description
List	collection Microsoft.Graph.Security.Zone	Obtenir une liste des objets de zone et leurs propriétés.
Create	microsoft.graph.security.zone	Créez un objet de zone .
Obtenir	microsoft.graph.security.zone	Obtenir un objet de zone par un zoneId spécifique.
Mettre à jour	microsoft.graph.security.zone	Mettre à jour les propriétés d’un objet de zone .
Supprimer	Aucun	Supprimez un objet de zone en fournissant le zoneId.

Propriétés

Propriété	Type	Description
créé	microsoft.graph.security.auditInfo	Métadonnées de création, y compris l’utilisateur et l’horodatage. Prend en charge $orderby (propriété dateTime uniquement). Prend en charge $filter (ge, , legt, lt, ) sur la propriété dateTime. Par exemple : $filter=created/dateTime ge 2023-01-01T00:00:00Z.
description	String	Description facultative de la zone. Jusqu’à 255 caractères. Prend en charge $filter (eq, contains). Par exemple : $filter=contains(description, 'production').
displayName	String	Nom lisible de la zone. Jusqu’à 1 024 caractères. Prend en charge $filter (eq, contains) et $orderby. Par exemple : $filter=displayName eq 'Production Zone' ou $orderby=displayName asc.
id	String	Identifiant unique de la zone. Hérité de l’entité. Prend en charge $filter (eq).
modifié	microsoft.graph.security.auditInfo	Métadonnées de la dernière modification, y compris l’utilisateur et l’horodatage. Prend en charge $orderby (propriété dateTime uniquement). Prend en charge $filter (ge, , legt, lt, ) sur la propriété dateTime. Par exemple : $orderby=modified/dateTime desc.

Relations

Relation	Type	Description
aggregations	collection microsoft.graph.security.aggregatedEnvironment	Récapitulatifs du nombre d’environnements par type. En lecture seule. Prend en charge $filter (eq) sur la propriété kind . Par exemple : $filter=aggregations/any(a: a/kind eq 'azureSubscription').
environnements	Microsoft.Graph.Security.Environment	Collection d’environnements attachés. Prend en charge $expand.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.security.zone",
  "created": {"@odata.type": "microsoft.graph.security.auditInfo"},
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "modified": {"@odata.type": "microsoft.graph.security.auditInfo"}
}