Create
|
|||||
|
|
||||
Create a new ManagedZone
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- View and manage your data across Google Cloud Platform services
- View and manage your DNS records hosted by Google Cloud DNS
Input
This building block consumes 27 input parameters
| Name | Format | Description |
|---|---|---|
project Required |
STRING |
Identifies the project addressed by this request |
clientOperationId |
STRING |
For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection |
creationTime |
STRING |
The time that this resource was created on the server. This is in RFC3339 text format. Output only |
description |
STRING |
A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the managed zone's function |
dnsName |
STRING |
The DNS name of this managed zone, for instance "example.com." |
dnssecConfig |
OBJECT |
|
dnssecConfig.defaultKeySpecs[] |
OBJECT |
Parameters for DnsKey key generation. Used for generating initial keys for a new ManagedZone and as default when adding a new DnsKey |
dnssecConfig.defaultKeySpecs[].algorithm |
ENUMERATION |
String mnemonic specifying the DNSSEC algorithm of this key |
dnssecConfig.defaultKeySpecs[].keyLength |
INTEGER |
Length of the keys in bits |
dnssecConfig.defaultKeySpecs[].keyType |
ENUMERATION |
Specifies whether this is a key signing key (KSK) or a zone signing key (ZSK). Key signing keys have the Secure Entry Point flag set and, when active, will only be used to sign resource record sets of type DNSKEY. Zone signing keys do not have the Secure Entry Point flag set and will be used to sign all other types of resource record sets |
dnssecConfig.defaultKeySpecs[].kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#dnsKeySpec" |
dnssecConfig.kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZoneDnsSecConfig" |
dnssecConfig.nonExistence |
ENUMERATION |
Specifies the mechanism used to provide authenticated denial-of-existence responses. Output only while state is not OFF |
dnssecConfig.state |
ENUMERATION |
Specifies whether DNSSEC is enabled, and what mode it is in |
id |
INTEGER |
Unique identifier for the resource; defined by the server (output only) |
kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZone" |
labels |
OBJECT |
User labels |
labels.customKey.value Required |
STRING |
User labels |
name |
STRING |
User assigned name for this resource. Must be unique within the project. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes |
nameServerSet |
STRING |
Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet is a set of DNS name servers that all host the same ManagedZones. Most users will leave this field unset |
nameServers[] |
STRING |
|
privateVisibilityConfig |
OBJECT |
|
privateVisibilityConfig.kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfig" |
privateVisibilityConfig.networks[] |
OBJECT |
|
privateVisibilityConfig.networks[].kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfigNetwork" |
privateVisibilityConfig.networks[].networkUrl |
STRING |
The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network} |
visibility |
ENUMERATION |
The zone's visibility: public zones are exposed to the Internet, while private zones are visible only to Virtual Private Cloud resources |
= Parameter name
= Format
|
project STRING Required Identifies the project addressed by this request |
|
clientOperationId STRING For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection |
|
creationTime STRING The time that this resource was created on the server. This is in RFC3339 text format. Output only |
|
description STRING A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the managed zone's function |
|
dnsName STRING The DNS name of this managed zone, for instance "example.com." |
|
dnssecConfig OBJECT |
|
dnssecConfig.defaultKeySpecs[] OBJECT Parameters for DnsKey key generation. Used for generating initial keys for a new ManagedZone and as default when adding a new DnsKey |
|
dnssecConfig.defaultKeySpecs[].algorithm ENUMERATION String mnemonic specifying the DNSSEC algorithm of this key |
|
dnssecConfig.defaultKeySpecs[].keyLength INTEGER Length of the keys in bits |
|
dnssecConfig.defaultKeySpecs[].keyType ENUMERATION Specifies whether this is a key signing key (KSK) or a zone signing key (ZSK). Key signing keys have the Secure Entry Point flag set and, when active, will only be used to sign resource record sets of type DNSKEY. Zone signing keys do not have the Secure Entry Point flag set and will be used to sign all other types of resource record sets |
|
dnssecConfig.defaultKeySpecs[].kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#dnsKeySpec" |
|
dnssecConfig.kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZoneDnsSecConfig" |
|
dnssecConfig.nonExistence ENUMERATION Specifies the mechanism used to provide authenticated denial-of-existence responses. Output only while state is not OFF |
|
dnssecConfig.state ENUMERATION Specifies whether DNSSEC is enabled, and what mode it is in |
|
id INTEGER Unique identifier for the resource; defined by the server (output only) |
|
kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZone" |
|
labels OBJECT User labels |
|
labels.customKey.value STRING Required User labels |
|
name STRING User assigned name for this resource. Must be unique within the project. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes |
|
nameServerSet STRING Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet is a set of DNS name servers that all host the same ManagedZones. Most users will leave this field unset |
|
nameServers[] STRING |
|
privateVisibilityConfig OBJECT |
|
privateVisibilityConfig.kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfig" |
|
privateVisibilityConfig.networks[] OBJECT |
|
privateVisibilityConfig.networks[].kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfigNetwork" |
|
privateVisibilityConfig.networks[].networkUrl STRING The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network} |
|
visibility ENUMERATION The zone's visibility: public zones are exposed to the Internet, while private zones are visible only to Virtual Private Cloud resources |
Output
This building block provides 25 output parameters
| Name | Format | Description |
|---|---|---|
creationTime |
STRING |
The time that this resource was created on the server. This is in RFC3339 text format. Output only |
description |
STRING |
A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the managed zone's function |
dnsName |
STRING |
The DNS name of this managed zone, for instance "example.com." |
dnssecConfig |
OBJECT |
|
dnssecConfig.defaultKeySpecs[] |
OBJECT |
Parameters for DnsKey key generation. Used for generating initial keys for a new ManagedZone and as default when adding a new DnsKey |
dnssecConfig.defaultKeySpecs[].algorithm |
ENUMERATION |
String mnemonic specifying the DNSSEC algorithm of this key |
dnssecConfig.defaultKeySpecs[].keyLength |
INTEGER |
Length of the keys in bits |
dnssecConfig.defaultKeySpecs[].keyType |
ENUMERATION |
Specifies whether this is a key signing key (KSK) or a zone signing key (ZSK). Key signing keys have the Secure Entry Point flag set and, when active, will only be used to sign resource record sets of type DNSKEY. Zone signing keys do not have the Secure Entry Point flag set and will be used to sign all other types of resource record sets |
dnssecConfig.defaultKeySpecs[].kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#dnsKeySpec" |
dnssecConfig.kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZoneDnsSecConfig" |
dnssecConfig.nonExistence |
ENUMERATION |
Specifies the mechanism used to provide authenticated denial-of-existence responses. Output only while state is not OFF |
dnssecConfig.state |
ENUMERATION |
Specifies whether DNSSEC is enabled, and what mode it is in |
id |
INTEGER |
Unique identifier for the resource; defined by the server (output only) |
kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZone" |
labels |
OBJECT |
User labels |
labels.customKey.value |
STRING |
User labels |
name |
STRING |
User assigned name for this resource. Must be unique within the project. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes |
nameServerSet |
STRING |
Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet is a set of DNS name servers that all host the same ManagedZones. Most users will leave this field unset |
nameServers[] |
STRING |
|
privateVisibilityConfig |
OBJECT |
|
privateVisibilityConfig.kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfig" |
privateVisibilityConfig.networks[] |
OBJECT |
|
privateVisibilityConfig.networks[].kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfigNetwork" |
privateVisibilityConfig.networks[].networkUrl |
STRING |
The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network} |
visibility |
ENUMERATION |
The zone's visibility: public zones are exposed to the Internet, while private zones are visible only to Virtual Private Cloud resources |
= Parameter name
= Format
|
creationTime STRING The time that this resource was created on the server. This is in RFC3339 text format. Output only |
|
description STRING A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the managed zone's function |
|
dnsName STRING The DNS name of this managed zone, for instance "example.com." |
|
dnssecConfig OBJECT |
|
dnssecConfig.defaultKeySpecs[] OBJECT Parameters for DnsKey key generation. Used for generating initial keys for a new ManagedZone and as default when adding a new DnsKey |
|
dnssecConfig.defaultKeySpecs[].algorithm ENUMERATION String mnemonic specifying the DNSSEC algorithm of this key |
|
dnssecConfig.defaultKeySpecs[].keyLength INTEGER Length of the keys in bits |
|
dnssecConfig.defaultKeySpecs[].keyType ENUMERATION Specifies whether this is a key signing key (KSK) or a zone signing key (ZSK). Key signing keys have the Secure Entry Point flag set and, when active, will only be used to sign resource record sets of type DNSKEY. Zone signing keys do not have the Secure Entry Point flag set and will be used to sign all other types of resource record sets |
|
dnssecConfig.defaultKeySpecs[].kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#dnsKeySpec" |
|
dnssecConfig.kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZoneDnsSecConfig" |
|
dnssecConfig.nonExistence ENUMERATION Specifies the mechanism used to provide authenticated denial-of-existence responses. Output only while state is not OFF |
|
dnssecConfig.state ENUMERATION Specifies whether DNSSEC is enabled, and what mode it is in |
|
id INTEGER Unique identifier for the resource; defined by the server (output only) |
|
kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZone" |
|
labels OBJECT User labels |
|
labels.customKey.value STRING User labels |
|
name STRING User assigned name for this resource. Must be unique within the project. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes |
|
nameServerSet STRING Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet is a set of DNS name servers that all host the same ManagedZones. Most users will leave this field unset |
|
nameServers[] STRING |
|
privateVisibilityConfig OBJECT |
|
privateVisibilityConfig.kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfig" |
|
privateVisibilityConfig.networks[] OBJECT |
|
privateVisibilityConfig.networks[].kind STRING Identifies what kind of resource this is. Value: the fixed string "dns#managedZonePrivateVisibilityConfigNetwork" |
|
privateVisibilityConfig.networks[].networkUrl STRING The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network} |
|
visibility ENUMERATION The zone's visibility: public zones are exposed to the Internet, while private zones are visible only to Virtual Private Cloud resources |