gcp.projects.ApiKey
Explore with Pulumi AI
The Apikeys Key resource
Example Usage
Android_key
A basic example of a android api keys key
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const primary = new gcp.projects.ApiKey("primary", {
name: "key",
displayName: "sample-key",
restrictions: {
androidKeyRestrictions: {
allowedApplications: [{
packageName: "com.example.app123",
sha1Fingerprint: "1699466a142d4682a5f91b50fdf400f2358e2b0b",
}],
},
apiTargets: [{
service: "translate.googleapis.com",
methods: ["GET*"],
}],
},
});
import pulumi
import pulumi_gcp as gcp
primary = gcp.projects.ApiKey("primary",
name="key",
display_name="sample-key",
restrictions={
"android_key_restrictions": {
"allowed_applications": [{
"package_name": "com.example.app123",
"sha1_fingerprint": "1699466a142d4682a5f91b50fdf400f2358e2b0b",
}],
},
"api_targets": [{
"service": "translate.googleapis.com",
"methods": ["GET*"],
}],
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/projects"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := projects.NewApiKey(ctx, "primary", &projects.ApiKeyArgs{
Name: pulumi.String("key"),
DisplayName: pulumi.String("sample-key"),
Restrictions: &projects.ApiKeyRestrictionsArgs{
AndroidKeyRestrictions: &projects.ApiKeyRestrictionsAndroidKeyRestrictionsArgs{
AllowedApplications: projects.ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArray{
&projects.ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArgs{
PackageName: pulumi.String("com.example.app123"),
Sha1Fingerprint: pulumi.String("1699466a142d4682a5f91b50fdf400f2358e2b0b"),
},
},
},
ApiTargets: projects.ApiKeyRestrictionsApiTargetArray{
&projects.ApiKeyRestrictionsApiTargetArgs{
Service: pulumi.String("translate.googleapis.com"),
Methods: pulumi.StringArray{
pulumi.String("GET*"),
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var primary = new Gcp.Projects.ApiKey("primary", new()
{
Name = "key",
DisplayName = "sample-key",
Restrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsArgs
{
AndroidKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsAndroidKeyRestrictionsArgs
{
AllowedApplications = new[]
{
new Gcp.Projects.Inputs.ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArgs
{
PackageName = "com.example.app123",
Sha1Fingerprint = "1699466a142d4682a5f91b50fdf400f2358e2b0b",
},
},
},
ApiTargets = new[]
{
new Gcp.Projects.Inputs.ApiKeyRestrictionsApiTargetArgs
{
Service = "translate.googleapis.com",
Methods = new[]
{
"GET*",
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.projects.ApiKey;
import com.pulumi.gcp.projects.ApiKeyArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsAndroidKeyRestrictionsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var primary = new ApiKey("primary", ApiKeyArgs.builder()
.name("key")
.displayName("sample-key")
.restrictions(ApiKeyRestrictionsArgs.builder()
.androidKeyRestrictions(ApiKeyRestrictionsAndroidKeyRestrictionsArgs.builder()
.allowedApplications(ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArgs.builder()
.packageName("com.example.app123")
.sha1Fingerprint("1699466a142d4682a5f91b50fdf400f2358e2b0b")
.build())
.build())
.apiTargets(ApiKeyRestrictionsApiTargetArgs.builder()
.service("translate.googleapis.com")
.methods("GET*")
.build())
.build())
.build());
}
}
resources:
primary:
type: gcp:projects:ApiKey
properties:
name: key
displayName: sample-key
restrictions:
androidKeyRestrictions:
allowedApplications:
- packageName: com.example.app123
sha1Fingerprint: 1699466a142d4682a5f91b50fdf400f2358e2b0b
apiTargets:
- service: translate.googleapis.com
methods:
- GET*
Basic_key
A basic example of a api keys key
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const primary = new gcp.projects.ApiKey("primary", {
name: "key",
displayName: "sample-key",
restrictions: {
apiTargets: [{
service: "translate.googleapis.com",
methods: ["GET*"],
}],
browserKeyRestrictions: {
allowedReferrers: [".*"],
},
},
});
import pulumi
import pulumi_gcp as gcp
primary = gcp.projects.ApiKey("primary",
name="key",
display_name="sample-key",
restrictions={
"api_targets": [{
"service": "translate.googleapis.com",
"methods": ["GET*"],
}],
"browser_key_restrictions": {
"allowed_referrers": [".*"],
},
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/projects"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := projects.NewApiKey(ctx, "primary", &projects.ApiKeyArgs{
Name: pulumi.String("key"),
DisplayName: pulumi.String("sample-key"),
Restrictions: &projects.ApiKeyRestrictionsArgs{
ApiTargets: projects.ApiKeyRestrictionsApiTargetArray{
&projects.ApiKeyRestrictionsApiTargetArgs{
Service: pulumi.String("translate.googleapis.com"),
Methods: pulumi.StringArray{
pulumi.String("GET*"),
},
},
},
BrowserKeyRestrictions: &projects.ApiKeyRestrictionsBrowserKeyRestrictionsArgs{
AllowedReferrers: pulumi.StringArray{
pulumi.String(".*"),
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var primary = new Gcp.Projects.ApiKey("primary", new()
{
Name = "key",
DisplayName = "sample-key",
Restrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsArgs
{
ApiTargets = new[]
{
new Gcp.Projects.Inputs.ApiKeyRestrictionsApiTargetArgs
{
Service = "translate.googleapis.com",
Methods = new[]
{
"GET*",
},
},
},
BrowserKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsBrowserKeyRestrictionsArgs
{
AllowedReferrers = new[]
{
".*",
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.projects.ApiKey;
import com.pulumi.gcp.projects.ApiKeyArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsBrowserKeyRestrictionsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var primary = new ApiKey("primary", ApiKeyArgs.builder()
.name("key")
.displayName("sample-key")
.restrictions(ApiKeyRestrictionsArgs.builder()
.apiTargets(ApiKeyRestrictionsApiTargetArgs.builder()
.service("translate.googleapis.com")
.methods("GET*")
.build())
.browserKeyRestrictions(ApiKeyRestrictionsBrowserKeyRestrictionsArgs.builder()
.allowedReferrers(".*")
.build())
.build())
.build());
}
}
resources:
primary:
type: gcp:projects:ApiKey
properties:
name: key
displayName: sample-key
restrictions:
apiTargets:
- service: translate.googleapis.com
methods:
- GET*
browserKeyRestrictions:
allowedReferrers:
- .*
Ios_key
A basic example of a ios api keys key
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const primary = new gcp.projects.ApiKey("primary", {
name: "key",
displayName: "sample-key",
restrictions: {
apiTargets: [{
service: "translate.googleapis.com",
methods: ["GET*"],
}],
iosKeyRestrictions: {
allowedBundleIds: ["com.google.app.macos"],
},
},
});
import pulumi
import pulumi_gcp as gcp
primary = gcp.projects.ApiKey("primary",
name="key",
display_name="sample-key",
restrictions={
"api_targets": [{
"service": "translate.googleapis.com",
"methods": ["GET*"],
}],
"ios_key_restrictions": {
"allowed_bundle_ids": ["com.google.app.macos"],
},
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/projects"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := projects.NewApiKey(ctx, "primary", &projects.ApiKeyArgs{
Name: pulumi.String("key"),
DisplayName: pulumi.String("sample-key"),
Restrictions: &projects.ApiKeyRestrictionsArgs{
ApiTargets: projects.ApiKeyRestrictionsApiTargetArray{
&projects.ApiKeyRestrictionsApiTargetArgs{
Service: pulumi.String("translate.googleapis.com"),
Methods: pulumi.StringArray{
pulumi.String("GET*"),
},
},
},
IosKeyRestrictions: &projects.ApiKeyRestrictionsIosKeyRestrictionsArgs{
AllowedBundleIds: pulumi.StringArray{
pulumi.String("com.google.app.macos"),
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var primary = new Gcp.Projects.ApiKey("primary", new()
{
Name = "key",
DisplayName = "sample-key",
Restrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsArgs
{
ApiTargets = new[]
{
new Gcp.Projects.Inputs.ApiKeyRestrictionsApiTargetArgs
{
Service = "translate.googleapis.com",
Methods = new[]
{
"GET*",
},
},
},
IosKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsIosKeyRestrictionsArgs
{
AllowedBundleIds = new[]
{
"com.google.app.macos",
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.projects.ApiKey;
import com.pulumi.gcp.projects.ApiKeyArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsIosKeyRestrictionsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var primary = new ApiKey("primary", ApiKeyArgs.builder()
.name("key")
.displayName("sample-key")
.restrictions(ApiKeyRestrictionsArgs.builder()
.apiTargets(ApiKeyRestrictionsApiTargetArgs.builder()
.service("translate.googleapis.com")
.methods("GET*")
.build())
.iosKeyRestrictions(ApiKeyRestrictionsIosKeyRestrictionsArgs.builder()
.allowedBundleIds("com.google.app.macos")
.build())
.build())
.build());
}
}
resources:
primary:
type: gcp:projects:ApiKey
properties:
name: key
displayName: sample-key
restrictions:
apiTargets:
- service: translate.googleapis.com
methods:
- GET*
iosKeyRestrictions:
allowedBundleIds:
- com.google.app.macos
Minimal_key
A minimal example of a api keys key
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const primary = new gcp.projects.ApiKey("primary", {
name: "key",
displayName: "sample-key",
});
import pulumi
import pulumi_gcp as gcp
primary = gcp.projects.ApiKey("primary",
name="key",
display_name="sample-key")
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/projects"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := projects.NewApiKey(ctx, "primary", &projects.ApiKeyArgs{
Name: pulumi.String("key"),
DisplayName: pulumi.String("sample-key"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var primary = new Gcp.Projects.ApiKey("primary", new()
{
Name = "key",
DisplayName = "sample-key",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.projects.ApiKey;
import com.pulumi.gcp.projects.ApiKeyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var primary = new ApiKey("primary", ApiKeyArgs.builder()
.name("key")
.displayName("sample-key")
.build());
}
}
resources:
primary:
type: gcp:projects:ApiKey
properties:
name: key
displayName: sample-key
Server_key
A basic example of a server api keys key
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const primary = new gcp.projects.ApiKey("primary", {
name: "key",
displayName: "sample-key",
restrictions: {
apiTargets: [{
service: "translate.googleapis.com",
methods: ["GET*"],
}],
serverKeyRestrictions: {
allowedIps: ["127.0.0.1"],
},
},
});
import pulumi
import pulumi_gcp as gcp
primary = gcp.projects.ApiKey("primary",
name="key",
display_name="sample-key",
restrictions={
"api_targets": [{
"service": "translate.googleapis.com",
"methods": ["GET*"],
}],
"server_key_restrictions": {
"allowed_ips": ["127.0.0.1"],
},
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/projects"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := projects.NewApiKey(ctx, "primary", &projects.ApiKeyArgs{
Name: pulumi.String("key"),
DisplayName: pulumi.String("sample-key"),
Restrictions: &projects.ApiKeyRestrictionsArgs{
ApiTargets: projects.ApiKeyRestrictionsApiTargetArray{
&projects.ApiKeyRestrictionsApiTargetArgs{
Service: pulumi.String("translate.googleapis.com"),
Methods: pulumi.StringArray{
pulumi.String("GET*"),
},
},
},
ServerKeyRestrictions: &projects.ApiKeyRestrictionsServerKeyRestrictionsArgs{
AllowedIps: pulumi.StringArray{
pulumi.String("127.0.0.1"),
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var primary = new Gcp.Projects.ApiKey("primary", new()
{
Name = "key",
DisplayName = "sample-key",
Restrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsArgs
{
ApiTargets = new[]
{
new Gcp.Projects.Inputs.ApiKeyRestrictionsApiTargetArgs
{
Service = "translate.googleapis.com",
Methods = new[]
{
"GET*",
},
},
},
ServerKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsServerKeyRestrictionsArgs
{
AllowedIps = new[]
{
"127.0.0.1",
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.projects.ApiKey;
import com.pulumi.gcp.projects.ApiKeyArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsArgs;
import com.pulumi.gcp.projects.inputs.ApiKeyRestrictionsServerKeyRestrictionsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var primary = new ApiKey("primary", ApiKeyArgs.builder()
.name("key")
.displayName("sample-key")
.restrictions(ApiKeyRestrictionsArgs.builder()
.apiTargets(ApiKeyRestrictionsApiTargetArgs.builder()
.service("translate.googleapis.com")
.methods("GET*")
.build())
.serverKeyRestrictions(ApiKeyRestrictionsServerKeyRestrictionsArgs.builder()
.allowedIps("127.0.0.1")
.build())
.build())
.build());
}
}
resources:
primary:
type: gcp:projects:ApiKey
properties:
name: key
displayName: sample-key
restrictions:
apiTargets:
- service: translate.googleapis.com
methods:
- GET*
serverKeyRestrictions:
allowedIps:
- 127.0.0.1
Create ApiKey Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new ApiKey(name: string, args?: ApiKeyArgs, opts?: CustomResourceOptions);
@overload
def ApiKey(resource_name: str,
args: Optional[ApiKeyArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def ApiKey(resource_name: str,
opts: Optional[ResourceOptions] = None,
display_name: Optional[str] = None,
name: Optional[str] = None,
project: Optional[str] = None,
restrictions: Optional[ApiKeyRestrictionsArgs] = None)
func NewApiKey(ctx *Context, name string, args *ApiKeyArgs, opts ...ResourceOption) (*ApiKey, error)
public ApiKey(string name, ApiKeyArgs? args = null, CustomResourceOptions? opts = null)
public ApiKey(String name, ApiKeyArgs args)
public ApiKey(String name, ApiKeyArgs args, CustomResourceOptions options)
type: gcp:projects:ApiKey
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ApiKeyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ApiKeyArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ApiKeyArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ApiKeyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ApiKeyArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var apiKeyResource = new Gcp.Projects.ApiKey("apiKeyResource", new()
{
DisplayName = "string",
Name = "string",
Project = "string",
Restrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsArgs
{
AndroidKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsAndroidKeyRestrictionsArgs
{
AllowedApplications = new[]
{
new Gcp.Projects.Inputs.ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArgs
{
PackageName = "string",
Sha1Fingerprint = "string",
},
},
},
ApiTargets = new[]
{
new Gcp.Projects.Inputs.ApiKeyRestrictionsApiTargetArgs
{
Service = "string",
Methods = new[]
{
"string",
},
},
},
BrowserKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsBrowserKeyRestrictionsArgs
{
AllowedReferrers = new[]
{
"string",
},
},
IosKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsIosKeyRestrictionsArgs
{
AllowedBundleIds = new[]
{
"string",
},
},
ServerKeyRestrictions = new Gcp.Projects.Inputs.ApiKeyRestrictionsServerKeyRestrictionsArgs
{
AllowedIps = new[]
{
"string",
},
},
},
});
example, err := projects.NewApiKey(ctx, "apiKeyResource", &projects.ApiKeyArgs{
DisplayName: pulumi.String("string"),
Name: pulumi.String("string"),
Project: pulumi.String("string"),
Restrictions: &projects.ApiKeyRestrictionsArgs{
AndroidKeyRestrictions: &projects.ApiKeyRestrictionsAndroidKeyRestrictionsArgs{
AllowedApplications: projects.ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArray{
&projects.ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArgs{
PackageName: pulumi.String("string"),
Sha1Fingerprint: pulumi.String("string"),
},
},
},
ApiTargets: projects.ApiKeyRestrictionsApiTargetArray{
&projects.ApiKeyRestrictionsApiTargetArgs{
Service: pulumi.String("string"),
Methods: pulumi.StringArray{
pulumi.String("string"),
},
},
},
BrowserKeyRestrictions: &projects.ApiKeyRestrictionsBrowserKeyRestrictionsArgs{
AllowedReferrers: pulumi.StringArray{
pulumi.String("string"),
},
},
IosKeyRestrictions: &projects.ApiKeyRestrictionsIosKeyRestrictionsArgs{
AllowedBundleIds: pulumi.StringArray{
pulumi.String("string"),
},
},
ServerKeyRestrictions: &projects.ApiKeyRestrictionsServerKeyRestrictionsArgs{
AllowedIps: pulumi.StringArray{
pulumi.String("string"),
},
},
},
})
var apiKeyResource = new ApiKey("apiKeyResource", ApiKeyArgs.builder()
.displayName("string")
.name("string")
.project("string")
.restrictions(ApiKeyRestrictionsArgs.builder()
.androidKeyRestrictions(ApiKeyRestrictionsAndroidKeyRestrictionsArgs.builder()
.allowedApplications(ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArgs.builder()
.packageName("string")
.sha1Fingerprint("string")
.build())
.build())
.apiTargets(ApiKeyRestrictionsApiTargetArgs.builder()
.service("string")
.methods("string")
.build())
.browserKeyRestrictions(ApiKeyRestrictionsBrowserKeyRestrictionsArgs.builder()
.allowedReferrers("string")
.build())
.iosKeyRestrictions(ApiKeyRestrictionsIosKeyRestrictionsArgs.builder()
.allowedBundleIds("string")
.build())
.serverKeyRestrictions(ApiKeyRestrictionsServerKeyRestrictionsArgs.builder()
.allowedIps("string")
.build())
.build())
.build());
api_key_resource = gcp.projects.ApiKey("apiKeyResource",
display_name="string",
name="string",
project="string",
restrictions={
"android_key_restrictions": {
"allowed_applications": [{
"package_name": "string",
"sha1_fingerprint": "string",
}],
},
"api_targets": [{
"service": "string",
"methods": ["string"],
}],
"browser_key_restrictions": {
"allowed_referrers": ["string"],
},
"ios_key_restrictions": {
"allowed_bundle_ids": ["string"],
},
"server_key_restrictions": {
"allowed_ips": ["string"],
},
})
const apiKeyResource = new gcp.projects.ApiKey("apiKeyResource", {
displayName: "string",
name: "string",
project: "string",
restrictions: {
androidKeyRestrictions: {
allowedApplications: [{
packageName: "string",
sha1Fingerprint: "string",
}],
},
apiTargets: [{
service: "string",
methods: ["string"],
}],
browserKeyRestrictions: {
allowedReferrers: ["string"],
},
iosKeyRestrictions: {
allowedBundleIds: ["string"],
},
serverKeyRestrictions: {
allowedIps: ["string"],
},
},
});
type: gcp:projects:ApiKey
properties:
displayName: string
name: string
project: string
restrictions:
androidKeyRestrictions:
allowedApplications:
- packageName: string
sha1Fingerprint: string
apiTargets:
- methods:
- string
service: string
browserKeyRestrictions:
allowedReferrers:
- string
iosKeyRestrictions:
allowedBundleIds:
- string
serverKeyRestrictions:
allowedIps:
- string
ApiKey Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The ApiKey resource accepts the following input properties:
- Display
Name string - Human-readable display name of this API key. Modifiable by user.
- Name string
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - Project string
- The project for the resource
- Restrictions
Api
Key Restrictions - Key restrictions.
- Display
Name string - Human-readable display name of this API key. Modifiable by user.
- Name string
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - Project string
- The project for the resource
- Restrictions
Api
Key Restrictions Args - Key restrictions.
- display
Name String - Human-readable display name of this API key. Modifiable by user.
- name String
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project String
- The project for the resource
- restrictions
Api
Key Restrictions - Key restrictions.
- display
Name string - Human-readable display name of this API key. Modifiable by user.
- name string
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project string
- The project for the resource
- restrictions
Api
Key Restrictions - Key restrictions.
- display_
name str - Human-readable display name of this API key. Modifiable by user.
- name str
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project str
- The project for the resource
- restrictions
Api
Key Restrictions Args - Key restrictions.
- display
Name String - Human-readable display name of this API key. Modifiable by user.
- name String
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project String
- The project for the resource
- restrictions Property Map
- Key restrictions.
Outputs
All input properties are implicitly available as output properties. Additionally, the ApiKey resource produces the following output properties:
- id str
- The provider-assigned unique ID for this managed resource.
- key_
string str - Output only. An encrypted and signed value held by this key. This field can be accessed only through the
GetKeyString
method. - uid str
- Output only. Unique id in UUID4 format.
Look up Existing ApiKey Resource
Get an existing ApiKey resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: ApiKeyState, opts?: CustomResourceOptions): ApiKey
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
display_name: Optional[str] = None,
key_string: Optional[str] = None,
name: Optional[str] = None,
project: Optional[str] = None,
restrictions: Optional[ApiKeyRestrictionsArgs] = None,
uid: Optional[str] = None) -> ApiKey
func GetApiKey(ctx *Context, name string, id IDInput, state *ApiKeyState, opts ...ResourceOption) (*ApiKey, error)
public static ApiKey Get(string name, Input<string> id, ApiKeyState? state, CustomResourceOptions? opts = null)
public static ApiKey get(String name, Output<String> id, ApiKeyState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Display
Name string - Human-readable display name of this API key. Modifiable by user.
- Key
String string - Output only. An encrypted and signed value held by this key. This field can be accessed only through the
GetKeyString
method. - Name string
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - Project string
- The project for the resource
- Restrictions
Api
Key Restrictions - Key restrictions.
- Uid string
- Output only. Unique id in UUID4 format.
- Display
Name string - Human-readable display name of this API key. Modifiable by user.
- Key
String string - Output only. An encrypted and signed value held by this key. This field can be accessed only through the
GetKeyString
method. - Name string
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - Project string
- The project for the resource
- Restrictions
Api
Key Restrictions Args - Key restrictions.
- Uid string
- Output only. Unique id in UUID4 format.
- display
Name String - Human-readable display name of this API key. Modifiable by user.
- key
String String - Output only. An encrypted and signed value held by this key. This field can be accessed only through the
GetKeyString
method. - name String
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project String
- The project for the resource
- restrictions
Api
Key Restrictions - Key restrictions.
- uid String
- Output only. Unique id in UUID4 format.
- display
Name string - Human-readable display name of this API key. Modifiable by user.
- key
String string - Output only. An encrypted and signed value held by this key. This field can be accessed only through the
GetKeyString
method. - name string
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project string
- The project for the resource
- restrictions
Api
Key Restrictions - Key restrictions.
- uid string
- Output only. Unique id in UUID4 format.
- display_
name str - Human-readable display name of this API key. Modifiable by user.
- key_
string str - Output only. An encrypted and signed value held by this key. This field can be accessed only through the
GetKeyString
method. - name str
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project str
- The project for the resource
- restrictions
Api
Key Restrictions Args - Key restrictions.
- uid str
- Output only. Unique id in UUID4 format.
- display
Name String - Human-readable display name of this API key. Modifiable by user.
- key
String String - Output only. An encrypted and signed value held by this key. This field can be accessed only through the
GetKeyString
method. - name String
- The resource name of the key. The name must be unique within the project, must conform with RFC-1034, is restricted to lower-cased letters, and has a maximum length of 63 characters. In another word, the name must match the regular expression:
a-z?
. - project String
- The project for the resource
- restrictions Property Map
- Key restrictions.
- uid String
- Output only. Unique id in UUID4 format.
Supporting Types
ApiKeyRestrictions, ApiKeyRestrictionsArgs
- Android
Key ApiRestrictions Key Restrictions Android Key Restrictions - The Android apps that are allowed to use the key.
- Api
Targets List<ApiKey Restrictions Api Target> - A restriction for a specific service and optionally one or more specific methods. Requests are allowed if they match any of these restrictions. If no restrictions are specified, all targets are allowed.
- Browser
Key ApiRestrictions Key Restrictions Browser Key Restrictions - The HTTP referrers (websites) that are allowed to use the key.
- Ios
Key ApiRestrictions Key Restrictions Ios Key Restrictions - The iOS apps that are allowed to use the key.
- Server
Key ApiRestrictions Key Restrictions Server Key Restrictions - The IP addresses of callers that are allowed to use the key.
- Android
Key ApiRestrictions Key Restrictions Android Key Restrictions - The Android apps that are allowed to use the key.
- Api
Targets []ApiKey Restrictions Api Target - A restriction for a specific service and optionally one or more specific methods. Requests are allowed if they match any of these restrictions. If no restrictions are specified, all targets are allowed.
- Browser
Key ApiRestrictions Key Restrictions Browser Key Restrictions - The HTTP referrers (websites) that are allowed to use the key.
- Ios
Key ApiRestrictions Key Restrictions Ios Key Restrictions - The iOS apps that are allowed to use the key.
- Server
Key ApiRestrictions Key Restrictions Server Key Restrictions - The IP addresses of callers that are allowed to use the key.
- android
Key ApiRestrictions Key Restrictions Android Key Restrictions - The Android apps that are allowed to use the key.
- api
Targets List<ApiKey Restrictions Api Target> - A restriction for a specific service and optionally one or more specific methods. Requests are allowed if they match any of these restrictions. If no restrictions are specified, all targets are allowed.
- browser
Key ApiRestrictions Key Restrictions Browser Key Restrictions - The HTTP referrers (websites) that are allowed to use the key.
- ios
Key ApiRestrictions Key Restrictions Ios Key Restrictions - The iOS apps that are allowed to use the key.
- server
Key ApiRestrictions Key Restrictions Server Key Restrictions - The IP addresses of callers that are allowed to use the key.
- android
Key ApiRestrictions Key Restrictions Android Key Restrictions - The Android apps that are allowed to use the key.
- api
Targets ApiKey Restrictions Api Target[] - A restriction for a specific service and optionally one or more specific methods. Requests are allowed if they match any of these restrictions. If no restrictions are specified, all targets are allowed.
- browser
Key ApiRestrictions Key Restrictions Browser Key Restrictions - The HTTP referrers (websites) that are allowed to use the key.
- ios
Key ApiRestrictions Key Restrictions Ios Key Restrictions - The iOS apps that are allowed to use the key.
- server
Key ApiRestrictions Key Restrictions Server Key Restrictions - The IP addresses of callers that are allowed to use the key.
- android_
key_ Apirestrictions Key Restrictions Android Key Restrictions - The Android apps that are allowed to use the key.
- api_
targets Sequence[ApiKey Restrictions Api Target] - A restriction for a specific service and optionally one or more specific methods. Requests are allowed if they match any of these restrictions. If no restrictions are specified, all targets are allowed.
- browser_
key_ Apirestrictions Key Restrictions Browser Key Restrictions - The HTTP referrers (websites) that are allowed to use the key.
- ios_
key_ Apirestrictions Key Restrictions Ios Key Restrictions - The iOS apps that are allowed to use the key.
- server_
key_ Apirestrictions Key Restrictions Server Key Restrictions - The IP addresses of callers that are allowed to use the key.
- android
Key Property MapRestrictions - The Android apps that are allowed to use the key.
- api
Targets List<Property Map> - A restriction for a specific service and optionally one or more specific methods. Requests are allowed if they match any of these restrictions. If no restrictions are specified, all targets are allowed.
- browser
Key Property MapRestrictions - The HTTP referrers (websites) that are allowed to use the key.
- ios
Key Property MapRestrictions - The iOS apps that are allowed to use the key.
- server
Key Property MapRestrictions - The IP addresses of callers that are allowed to use the key.
ApiKeyRestrictionsAndroidKeyRestrictions, ApiKeyRestrictionsAndroidKeyRestrictionsArgs
- Allowed
Applications List<ApiKey Restrictions Android Key Restrictions Allowed Application> - A list of Android applications that are allowed to make API calls with this key.
- Allowed
Applications []ApiKey Restrictions Android Key Restrictions Allowed Application - A list of Android applications that are allowed to make API calls with this key.
- allowed
Applications List<ApiKey Restrictions Android Key Restrictions Allowed Application> - A list of Android applications that are allowed to make API calls with this key.
- allowed
Applications ApiKey Restrictions Android Key Restrictions Allowed Application[] - A list of Android applications that are allowed to make API calls with this key.
- allowed_
applications Sequence[ApiKey Restrictions Android Key Restrictions Allowed Application] - A list of Android applications that are allowed to make API calls with this key.
- allowed
Applications List<Property Map> - A list of Android applications that are allowed to make API calls with this key.
ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplication, ApiKeyRestrictionsAndroidKeyRestrictionsAllowedApplicationArgs
- Package
Name string - The package name of the application.
- Sha1Fingerprint string
- The SHA1 fingerprint of the application. For example, both sha1 formats are acceptable : DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09 or DA39A3EE5E6B4B0D3255BFEF95601890AFD80709. Output format is the latter.
- Package
Name string - The package name of the application.
- Sha1Fingerprint string
- The SHA1 fingerprint of the application. For example, both sha1 formats are acceptable : DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09 or DA39A3EE5E6B4B0D3255BFEF95601890AFD80709. Output format is the latter.
- package
Name String - The package name of the application.
- sha1Fingerprint String
- The SHA1 fingerprint of the application. For example, both sha1 formats are acceptable : DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09 or DA39A3EE5E6B4B0D3255BFEF95601890AFD80709. Output format is the latter.
- package
Name string - The package name of the application.
- sha1Fingerprint string
- The SHA1 fingerprint of the application. For example, both sha1 formats are acceptable : DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09 or DA39A3EE5E6B4B0D3255BFEF95601890AFD80709. Output format is the latter.
- package_
name str - The package name of the application.
- sha1_
fingerprint str - The SHA1 fingerprint of the application. For example, both sha1 formats are acceptable : DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09 or DA39A3EE5E6B4B0D3255BFEF95601890AFD80709. Output format is the latter.
- package
Name String - The package name of the application.
- sha1Fingerprint String
- The SHA1 fingerprint of the application. For example, both sha1 formats are acceptable : DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09 or DA39A3EE5E6B4B0D3255BFEF95601890AFD80709. Output format is the latter.
ApiKeyRestrictionsApiTarget, ApiKeyRestrictionsApiTargetArgs
- Service string
- The service for this restriction. It should be the canonical service name, for example:
translate.googleapis.com
. You can usegcloud services list
to get a list of services that are enabled in the project. - Methods List<string>
- Optional. List of one or more methods that can be called. If empty, all methods for the service are allowed. A wildcard (*) can be used as the last symbol. Valid examples:
google.cloud.translate.v2.TranslateService.GetSupportedLanguage
TranslateText
Get*
translate.googleapis.com.Get*
- Service string
- The service for this restriction. It should be the canonical service name, for example:
translate.googleapis.com
. You can usegcloud services list
to get a list of services that are enabled in the project. - Methods []string
- Optional. List of one or more methods that can be called. If empty, all methods for the service are allowed. A wildcard (*) can be used as the last symbol. Valid examples:
google.cloud.translate.v2.TranslateService.GetSupportedLanguage
TranslateText
Get*
translate.googleapis.com.Get*
- service String
- The service for this restriction. It should be the canonical service name, for example:
translate.googleapis.com
. You can usegcloud services list
to get a list of services that are enabled in the project. - methods List<String>
- Optional. List of one or more methods that can be called. If empty, all methods for the service are allowed. A wildcard (*) can be used as the last symbol. Valid examples:
google.cloud.translate.v2.TranslateService.GetSupportedLanguage
TranslateText
Get*
translate.googleapis.com.Get*
- service string
- The service for this restriction. It should be the canonical service name, for example:
translate.googleapis.com
. You can usegcloud services list
to get a list of services that are enabled in the project. - methods string[]
- Optional. List of one or more methods that can be called. If empty, all methods for the service are allowed. A wildcard (*) can be used as the last symbol. Valid examples:
google.cloud.translate.v2.TranslateService.GetSupportedLanguage
TranslateText
Get*
translate.googleapis.com.Get*
- service str
- The service for this restriction. It should be the canonical service name, for example:
translate.googleapis.com
. You can usegcloud services list
to get a list of services that are enabled in the project. - methods Sequence[str]
- Optional. List of one or more methods that can be called. If empty, all methods for the service are allowed. A wildcard (*) can be used as the last symbol. Valid examples:
google.cloud.translate.v2.TranslateService.GetSupportedLanguage
TranslateText
Get*
translate.googleapis.com.Get*
- service String
- The service for this restriction. It should be the canonical service name, for example:
translate.googleapis.com
. You can usegcloud services list
to get a list of services that are enabled in the project. - methods List<String>
- Optional. List of one or more methods that can be called. If empty, all methods for the service are allowed. A wildcard (*) can be used as the last symbol. Valid examples:
google.cloud.translate.v2.TranslateService.GetSupportedLanguage
TranslateText
Get*
translate.googleapis.com.Get*
ApiKeyRestrictionsBrowserKeyRestrictions, ApiKeyRestrictionsBrowserKeyRestrictionsArgs
- Allowed
Referrers List<string> - A list of regular expressions for the referrer URLs that are allowed to make API calls with this key.
- Allowed
Referrers []string - A list of regular expressions for the referrer URLs that are allowed to make API calls with this key.
- allowed
Referrers List<String> - A list of regular expressions for the referrer URLs that are allowed to make API calls with this key.
- allowed
Referrers string[] - A list of regular expressions for the referrer URLs that are allowed to make API calls with this key.
- allowed_
referrers Sequence[str] - A list of regular expressions for the referrer URLs that are allowed to make API calls with this key.
- allowed
Referrers List<String> - A list of regular expressions for the referrer URLs that are allowed to make API calls with this key.
ApiKeyRestrictionsIosKeyRestrictions, ApiKeyRestrictionsIosKeyRestrictionsArgs
- Allowed
Bundle List<string>Ids - A list of bundle IDs that are allowed when making API calls with this key.
- Allowed
Bundle []stringIds - A list of bundle IDs that are allowed when making API calls with this key.
- allowed
Bundle List<String>Ids - A list of bundle IDs that are allowed when making API calls with this key.
- allowed
Bundle string[]Ids - A list of bundle IDs that are allowed when making API calls with this key.
- allowed_
bundle_ Sequence[str]ids - A list of bundle IDs that are allowed when making API calls with this key.
- allowed
Bundle List<String>Ids - A list of bundle IDs that are allowed when making API calls with this key.
ApiKeyRestrictionsServerKeyRestrictions, ApiKeyRestrictionsServerKeyRestrictionsArgs
- Allowed
Ips List<string> - A list of the caller IP addresses that are allowed to make API calls with this key.
- Allowed
Ips []string - A list of the caller IP addresses that are allowed to make API calls with this key.
- allowed
Ips List<String> - A list of the caller IP addresses that are allowed to make API calls with this key.
- allowed
Ips string[] - A list of the caller IP addresses that are allowed to make API calls with this key.
- allowed_
ips Sequence[str] - A list of the caller IP addresses that are allowed to make API calls with this key.
- allowed
Ips List<String> - A list of the caller IP addresses that are allowed to make API calls with this key.
Import
Key can be imported using any of these accepted formats:
projects/{{project}}/locations/global/keys/{{name}}
{{project}}/{{name}}
{{name}}
When using the pulumi import
command, Key can be imported using one of the formats above. For example:
$ pulumi import gcp:projects/apiKey:ApiKey default projects/{{project}}/locations/global/keys/{{name}}
$ pulumi import gcp:projects/apiKey:ApiKey default {{project}}/{{name}}
$ pulumi import gcp:projects/apiKey:ApiKey default {{name}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-beta
Terraform Provider.