A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link.
result.preSharedKeys[].name
string
User provided name for this pre-shared key.
result.preSharedKeys[].ckn
string
An auto-generated Connectivity Association Key Name (CKN) for this key.
result.preSharedKeys[].cak
string
An auto-generated Connectivity Association Key (CAK) for this key.
result.preSharedKeys[].startTime
string
User provided timestamp on or after which this key is valid.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-28 UTC."],[[["\u003cp\u003eThis webpage details how to retrieve the \u003ccode\u003einterconnectMacsecConfig\u003c/code\u003e for a specific Interconnect using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is structured as \u003ccode\u003eGET https://compute.googleapis.com/compute/v1/projects/{project}/global/interconnects/{interconnect}/getMacsecConfig\u003c/code\u003e, and it uses gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires two path parameters: \u003ccode\u003eproject\u003c/code\u003e (the project ID) and \u003ccode\u003einterconnect\u003c/code\u003e (the name of the interconnect resource), with an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a JSON structure with pre-shared keys, each having properties like \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003eckn\u003c/code\u003e, \u003ccode\u003ecak\u003c/code\u003e, and \u003ccode\u003estartTime\u003c/code\u003e, and also an \u003ccode\u003eetag\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires specific OAuth scopes (\u003ccode\u003ecompute.readonly\u003c/code\u003e, \u003ccode\u003ecompute\u003c/code\u003e, or \u003ccode\u003ecloud-platform\u003c/code\u003e) or the IAM permission \u003ccode\u003ecompute.interconnects.getMacsecConfig\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: interconnects.getMacsecConfig\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.InterconnectsGetMacsecConfigResponse.SCHEMA_REPRESENTATION)\n - [JSON representation](#body.InterconnectsGetMacsecConfigResponse.SCHEMA_REPRESENTATION.resource.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nReturns the `interconnectMacsecConfig` for the specified Interconnect.\n\n### HTTP request\n\n`GET https://compute.googleapis.com/compute/v1/projects/{project}/global/interconnects/{interconnect}/getMacsecConfig`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the InterconnectsGetMacsecConfigRequest.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/compute.readonly`\n- `\n https://www.googleapis.com/auth/compute`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nIn addition to any permissions specified on the fields above, authorization requires one or more of the following [IAM](https://cloud.google.com/iam/docs/) permissions:\n\n- `compute.interconnects.getMacsecConfig`\n\nTo find predefined roles that contain those permissions, see [Compute Engine IAM Roles](/compute/docs/access/iam)."]]