app_profiles
Creates, updates, deletes, gets or lists an app_profiles
resource.
Overview
Name | app_profiles |
Type | Resource |
Id | google.bigtableadmin.app_profiles |
Fields
The following fields are returned by SELECT
queries:
- get
- list
Successful response
Name | Datatype | Description |
---|---|---|
name | string | The unique name of the app profile, up to 50 characters long. Values are of the form projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9* . |
dataBoostIsolationReadOnly | object | Specifies that this app profile is intended for read-only usage via the Data Boost feature. (id: DataBoostIsolationReadOnly) |
description | string | Long form description of the use case for this AppProfile. |
etag | string | Strongly validated etag for optimistic concurrency control. Preserve the value returned from GetAppProfile when calling UpdateAppProfile to fail the request if there has been a modification in the mean time. The update_mask of the request need not include etag for this protection to apply. See Wikipedia and RFC 7232 for more details. |
multiClusterRoutingUseAny | object | Use a multi-cluster routing policy. (id: MultiClusterRoutingUseAny) |
priority | string | This field has been deprecated in favor of standard_isolation.priority . If you set this field, standard_isolation.priority will be set instead. The priority of requests sent using this app profile. |
singleClusterRouting | object | Use a single-cluster routing policy. (id: SingleClusterRouting) |
standardIsolation | object | The standard options used for isolating this app profile's traffic from other use cases. (id: StandardIsolation) |
Successful response
Name | Datatype | Description |
---|---|---|
name | string | The unique name of the app profile, up to 50 characters long. Values are of the form projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9* . |
dataBoostIsolationReadOnly | object | Specifies that this app profile is intended for read-only usage via the Data Boost feature. (id: DataBoostIsolationReadOnly) |
description | string | Long form description of the use case for this AppProfile. |
etag | string | Strongly validated etag for optimistic concurrency control. Preserve the value returned from GetAppProfile when calling UpdateAppProfile to fail the request if there has been a modification in the mean time. The update_mask of the request need not include etag for this protection to apply. See Wikipedia and RFC 7232 for more details. |
multiClusterRoutingUseAny | object | Use a multi-cluster routing policy. (id: MultiClusterRoutingUseAny) |
priority | string | This field has been deprecated in favor of standard_isolation.priority . If you set this field, standard_isolation.priority will be set instead. The priority of requests sent using this app profile. |
singleClusterRouting | object | Use a single-cluster routing policy. (id: SingleClusterRouting) |
standardIsolation | object | The standard options used for isolating this app profile's traffic from other use cases. (id: StandardIsolation) |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get | select | projectsId , instancesId , appProfilesId | Gets information about an app profile. | |
list | select | projectsId , instancesId | pageSize , pageToken | Lists information about app profiles in an instance. |
create | insert | projectsId , instancesId | appProfileId , ignoreWarnings | Creates an app profile within an instance. |
patch | update | projectsId , instancesId , appProfilesId | updateMask , ignoreWarnings | Updates an app profile within an instance. |
delete | delete | projectsId , instancesId , appProfilesId | ignoreWarnings | Deletes an app profile from an instance. |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
appProfilesId | string | |
instancesId | string | |
projectsId | string | |
appProfileId | string | |
ignoreWarnings | boolean | |
pageSize | integer (int32) | |
pageToken | string | |
updateMask | string (google-fieldmask) |
SELECT
examples
- get
- list
Gets information about an app profile.
SELECT
name,
dataBoostIsolationReadOnly,
description,
etag,
multiClusterRoutingUseAny,
priority,
singleClusterRouting,
standardIsolation
FROM google.bigtableadmin.app_profiles
WHERE projectsId = '{{ projectsId }}' -- required
AND instancesId = '{{ instancesId }}' -- required
AND appProfilesId = '{{ appProfilesId }}' -- required;
Lists information about app profiles in an instance.
SELECT
name,
dataBoostIsolationReadOnly,
description,
etag,
multiClusterRoutingUseAny,
priority,
singleClusterRouting,
standardIsolation
FROM google.bigtableadmin.app_profiles
WHERE projectsId = '{{ projectsId }}' -- required
AND instancesId = '{{ instancesId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';
INSERT
examples
- create
- Manifest
Creates an app profile within an instance.
INSERT INTO google.bigtableadmin.app_profiles (
data__name,
data__etag,
data__description,
data__multiClusterRoutingUseAny,
data__singleClusterRouting,
data__priority,
data__standardIsolation,
data__dataBoostIsolationReadOnly,
projectsId,
instancesId,
appProfileId,
ignoreWarnings
)
SELECT
'{{ name }}',
'{{ etag }}',
'{{ description }}',
'{{ multiClusterRoutingUseAny }}',
'{{ singleClusterRouting }}',
'{{ priority }}',
'{{ standardIsolation }}',
'{{ dataBoostIsolationReadOnly }}',
'{{ projectsId }}',
'{{ instancesId }}',
'{{ appProfileId }}',
'{{ ignoreWarnings }}'
RETURNING
name,
dataBoostIsolationReadOnly,
description,
etag,
multiClusterRoutingUseAny,
priority,
singleClusterRouting,
standardIsolation
;
# Description fields are for documentation purposes
- name: app_profiles
props:
- name: projectsId
value: string
description: Required parameter for the app_profiles resource.
- name: instancesId
value: string
description: Required parameter for the app_profiles resource.
- name: name
value: string
description: >
The unique name of the app profile, up to 50 characters long. Values are of the form `projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9*`.
- name: etag
value: string
description: >
Strongly validated etag for optimistic concurrency control. Preserve the value returned from `GetAppProfile` when calling `UpdateAppProfile` to fail the request if there has been a modification in the mean time. The `update_mask` of the request need not include `etag` for this protection to apply. See [Wikipedia](https://en.wikipedia.org/wiki/HTTP_ETag) and [RFC 7232](https://tools.ietf.org/html/rfc7232#section-2.3) for more details.
- name: description
value: string
description: >
Long form description of the use case for this AppProfile.
- name: multiClusterRoutingUseAny
value: object
description: >
Use a multi-cluster routing policy.
- name: singleClusterRouting
value: object
description: >
Use a single-cluster routing policy.
- name: priority
value: string
description: >
This field has been deprecated in favor of `standard_isolation.priority`. If you set this field, `standard_isolation.priority` will be set instead. The priority of requests sent using this app profile.
valid_values: ['PRIORITY_UNSPECIFIED', 'PRIORITY_LOW', 'PRIORITY_MEDIUM', 'PRIORITY_HIGH']
- name: standardIsolation
value: object
description: >
The standard options used for isolating this app profile's traffic from other use cases.
- name: dataBoostIsolationReadOnly
value: object
description: >
Specifies that this app profile is intended for read-only usage via the Data Boost feature.
- name: appProfileId
value: string
- name: ignoreWarnings
value: boolean
UPDATE
examples
- patch
Updates an app profile within an instance.
UPDATE google.bigtableadmin.app_profiles
SET
data__name = '{{ name }}',
data__etag = '{{ etag }}',
data__description = '{{ description }}',
data__multiClusterRoutingUseAny = '{{ multiClusterRoutingUseAny }}',
data__singleClusterRouting = '{{ singleClusterRouting }}',
data__priority = '{{ priority }}',
data__standardIsolation = '{{ standardIsolation }}',
data__dataBoostIsolationReadOnly = '{{ dataBoostIsolationReadOnly }}'
WHERE
projectsId = '{{ projectsId }}' --required
AND instancesId = '{{ instancesId }}' --required
AND appProfilesId = '{{ appProfilesId }}' --required
AND updateMask = '{{ updateMask}}'
AND ignoreWarnings = {{ ignoreWarnings}}
RETURNING
name,
done,
error,
metadata,
response;
DELETE
examples
- delete
Deletes an app profile from an instance.
DELETE FROM google.bigtableadmin.app_profiles
WHERE projectsId = '{{ projectsId }}' --required
AND instancesId = '{{ instancesId }}' --required
AND appProfilesId = '{{ appProfilesId }}' --required
AND ignoreWarnings = '{{ ignoreWarnings }}';