ip-profile
ip-profile unassign
Stop an application using a profile.
writesrepeatable--dry-run
Detaches a profile from an application. The application answers every address again at once, unless another profile is still attached.
This also has to run before the profile itself can be deleted.
Usage
outplane ip-profile unassign <PROFILE> [flags]Arguments
| Argument | Type | Description |
|---|---|---|
PROFILE | string | Profile name or id. Required. |
Flags
| Flag | Type | Description |
|---|---|---|
--app | string | Application name or id. Defaults to the linked app. A flag rather than an argument, because the profile is the argument. |
The global flags apply as well.
Output
| Field | Type | Description |
|---|---|---|
action | string | One of assign, unassign. |
profile | string | |
profileId | string | |
app | string | |
appId | string | |
rules | int | |
changed | bool | False for a dry run, and false when it was not attached. |
Examples
See what would open up, without opening it
outplane ip-profile unassign office --app checkout --dry-run --jsonStop restricting an application
outplane ip-profile unassign office --app checkoutRead the result in a pipeline
outplane ip-profile unassign office --app checkout --json --fields app,changedWhat to Know
- Applies immediately, with no deployment. The application answers every address again as soon as the request returns, unless another profile is still attached.
- Idempotent. Detaching something that was not attached reports changed false and exits 0.
- Deleting a profile is refused while anything still uses it, so this is the command that has to run first.
Errors
Beyond 0 for success, this command exits with:
| Exit | Kind | Meaning |
|---|---|---|
2 | usage | Invalid arguments, unknown flag, or client-side validation failure. |
3 | auth | Not authenticated, token revoked or expired, or forbidden for this team. |
5 | not_found | The named resource does not exist, or is not visible to this credential. |
8 | upstream | The Out Plane API returned a server error. |
The code on the error object is one of ipprofile.not_found, app.not_found, context.no_app, usage.missing_argument. Branch on that, or on the exit status. The message is prose and changes.