[apigatewayv1] Inability to Use parentRef.from.name for Root Path Resource Creation in RestAPI

[avishaig1986]

Describe the bug
api gateway v1 - https://github.com/aws-controllers-k8s/apigateway-controller

When using API Gateway V1 controller, there is a limitation when attempting to create a Resource whose parent is the root path (/). This issue arises because the parentRef.from.name parameter, which is intended to reference the parent resource by name, is restricted to only recognize Resource names. However, the root path (/) is associated with the RestAPI rather than a Resource, making it impossible to use parentRef.from.name to reference it directly.

As a result, when creating a Resource with the root path as its parent, users must manually retrieve the .status.rootResourceID of the RestAPI after its creation. This additional step is necessary to obtain the root resource ID, which is then used in the ParentID field for creating the Resource.

Steps to reproduce
Attempt to apply the following yaml to the cluster:

apiVersion: apigateway.services.k8s.aws/v1alpha1
kind: RestAPI
metadata:
  name: api-gateway-name
spec:
  name: api-gateway-name
  description: "api-gateway-description"
  endpointConfiguration: 
    types:
      - PRIVATE
---
apiVersion: apigateway.services.k8s.aws/v1alpha1
kind: Resource
metadata:
  name: my-resource
spec:
  restAPIID: dev-hcp.export-root-resource-id
  restAPIRef:
    from:
      name: api-gateway-name
  parentRef:
    from:
      name: api-gateway-name #cannot use the name of a RestAPI , only name of another Resource

Expected outcome
It should be allowed to use the name of the RestAPI in the Resource parentRef.from.name , or have another parameter in Resource such as restApiParentRef.from.name for example

Actual outcome
The following error message appears:
resources.apigateway.services.k8s.aws "example-restapi-name" not found

conditions:
  - lastTransitionTime: 2025-02-26T10:24:40Z
    message: Reference resolution failed
    reason: resources.apigateway.services.k8s.aws "example-restapi-name" not found
    status: Unknown
    type: ACK.ReferencesResolved

Environment

• EKS Kubernetes version - 1.31
• AWS service targeted - Lambda Functions

[denzhel]

Same here, it only works if I provide the parentID:

apiVersion: apigateway.services.k8s.aws/v1alpha1
kind: Resource
metadata:
  name: bp-aws-ack-poc-parent-resource
spec:
  #parentRef:
  #  from:
  #    name: bp-aws-ack-poc
  parentID: 123123abc
  restAPIRef:
    from:
      name: bp-aws-ack-poc
  pathPart: bp-aws-ack-poc

If I uncomment the parentRef and comment ID it errors:

resources.apigateway.services.k8s.aws "bp-aws-ack-poc" not found