Publication et dépublication d'un service de chemin privé
After you verify a successful connexion à votre service de voie privée, you must publish your service for deployment to consumers.
Si un service de chemin privé n'est pas publié, il n'est pas accessible en dehors du compte.
L'édition permet à tout compte de demander l'accès au service Private Path. Si nécessaire, vous pouvez également dépublier lorsque l'accès est limité au compte qui a créé le service Private Path.
Vous pouvez publier et dépublier un service IBM Cloud® Private Path à l'aide de la console, du CLI, de l'API ou de Terraform.
Publication d'un service de chemin privé dans la console
Pour publier un service Private Path dans la console IBM Cloud, procédez comme suit :
-
Dans votre navigateur, ouvrez la console IBM Cloud et connectez-vous à votre compte.
-
Sélectionnez l'
menu de navigation, puis cliquez sur l'icône Infrastructure
> Réseau > Services de chemin privé.
-
Localisez le nom de votre nouveau service de chemin privé dans le tableau et cliquez sur le nom pour afficher la page des détails du service de chemin privé.
-
Cliquez sur Publier dans le menu Actions
.
La colonne Publication du tableau Services de chemins privés pour VPC devient
Published.
Le service de chemin privé est désormais exposé pour que d'autres comptes se connectent au service via des passerelles VPE (Virtual Private Endpoint).
Après la publication, le nom du service Private Path est visible par les clients qui se connectent au service Private Path.
Dépublier un service de chemin privé dans la console
Pour dépublier un service Private Path dans la console IBM Cloud, procédez comme suit :
- Dans votre navigateur, ouvrez la console IBM Cloud et connectez-vous à votre compte.
- Sélectionnez l'
Navigation, puis cliquez sur Infrastructure > Réseau > Services de chemin privé.
- Dans le tableau Services de chemin privé pour VPC, localisez le chemin privé que vous souhaitez dépublier, puis cliquez sur le nom de ce service de chemin privé.
- Sur la page de détails du service Private Path, cliquez sur le menu Actions, puis sur Dépublier.
- Confirmez que vous souhaitez dépublier votre service Private Path.
Publication d'un service de chemin privé à partir de l'interface de programmation
L'exemple suivant montre comment utiliser l'interface de ligne de commande pour publier un service de chemin privé.
Avant de commencer, assurez-vous de configurer votre environnement d'interface de ligne de commande (CLI).
Pour publier un service de chemin privé à partir de l'interface de ligne de commande, procédez comme suit:
- Entrez la commande suivante :
ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY
[--output JSON]
[-f, --force]
[-q, --quiet]
Où :
PRIVATE_PATH_SERVICE_GATEWAY- Indique l'ID ou le nom du service de chemin privé.
--output- Indique le format de sortie, seul JSON est pris en charge. Un parmi :
JSON. -q, --quiet- Supprime la sortie prolixe.
Exemples de commande
- Publier un service de chemin privé :
ibmcloud is ppsgp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1ibmcloud is private-path-service-gateway-publish cli-ppsg-0
Dépublier un service de chemin privé à partir de l'interface de ligne de commande
L'exemple suivant montre comment utiliser la CLI pour dépublier un service Private Path.
Avant de commencer, assurez-vous de configurer votre environnement d'interface de ligne de commande (CLI).
Pour dépublier un service de chemin privé à partir de l'interface de ligne de commande, procédez comme suit :
- Entrez la commande suivante :
ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY
[--output JSON]
[-f, --force]
[-q, --quiet]
Où :
PRIVATE_PATH_SERVICE_GATEWAY- Indique l'ID ou le nom du service de chemin privé.
--output- Indique le format de sortie, seul JSON est pris en charge. Un parmi :
JSON. -q, --quiet- Supprime la sortie prolixe.
Publication d'un service de chemin privé avec l'API
Pour publier un service de chemin privé avec l'API, procédez comme suit:
-
Configurez votre environnement d'API.
-
Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :
-
ppsgId-Obtenez votre service de chemin privé, puis renseignez la variable:export ppsgId=<your_ppsg_id>
-
-
Lorsque toutes les variables sont initialisées, publiez votre service Private Path :
curl -X POST -sH "Authorization:${iam_token}" \ "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/publish?version=$api_version&generation=2" \ -d {}'
Dépublier un service de chemin privé avec l'API
Pour dépublier un service de chemin privé avec l'API, procédez comme suit :
-
Configurez votre environnement d'API.
-
Stockez les valeurs suivantes dans les variables destinées à être utilisées dans la commande d'API :
-
ppsgId-Obtenez votre service de chemin privé, puis renseignez la variable:export ppsgId=<your_ppsg_id>
-
-
Lorsque toutes les variables sont initiées, dépubliez votre service Private Path :
curl -X POST -sH "Authorization:${iam_token}" \ "$vpc_api_endpoint/v1/private_path_service_gateways/$ppsgId/unpublish?version=$api_version&generation=2" \ -d {}'
Exemples de commande
- Publier un service de chemin privé :
ibmcloud is ppsgunp r006-01cd30f7-e6f2-432f-9520-76247b1fbbe1ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0
Publication d'un service de chemin privé avec Terraform
L'exemple suivant publie un réseau Private Path à l'aide de Terraform :
resource "ibm_is_private_path_service_gateway_operations" "publish" {
published = true
private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}
Pour obtenir de la documentation sur les ressources Terraform, consultez le Registre Terraform.
Dépublier un service de chemin privé avec Terraform
Terraform prendra en charge cette fonctionnalité une fois qu'elle aura atteint la disponibilité générale (GA) et qu'elle sera officiellement publiée.
L'exemple suivant permet de dépublier un réseau Private Path à l'aide de Terraform :
resource "ibm_is_private_path_service_gateway_operations" "publish" {
published = false
private_path_service_gateway = ibm_is_private_path_service_gateway.ppsg.id
}
Pour obtenir de la documentation sur les ressources Terraform, consultez le Registre Terraform.